nixtla

几行代码调用预训练模型，搞定时间序列预测与异常检测。

开源 🏷️定价信息待确认 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 344 🐛 待处理 65 👀 关注 37

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 4045

维护状态活跃

是否开源开源

定价模式 🏷️定价信息待确认

项目预览

项目数据

分类开源模型

开发团队Nixtla

官网地址https://www.nixtla.io/docs

GitHubhttps://github.com/Nixtla/nixtla

定价模式🏷️定价信息待确认

价格说明开源模型，无官网信息，定价待确认

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议NOASSERTION

主要语言Jupyter Notebook

技术栈/模型agent,agentic-ai,anomaly-detection,artificial-intelligence,deep-learning,forecasting,foundation-models,generative-ai-time-series,gpt,gpts,llm,llms,time-series,time-series-forecasting,timegpt

GitHub 星标★ 4045

上线时间2021-09-23 00:00:00

代码更新2026-11-09

仓库体积440.5 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数5

项目介绍

Nixtla 是一个专注于时间序列预测与异常检测的开源项目，其核心是 TimeGPT-1，一个生产级的预训练时间序列基础模型。该模型基于生成式预训练 Transformer 架构，在超过 1000 亿个数据点上训练而成，能够处理零售、电力、金融和物联网等多个领域的数据。用户只需几行代码即可调用模型进行高精度预测，无需针对特定数据集进行训练或微调。Nixtla 提供了简洁的 Python API，支持快速集成到现有数据管道中，同时具备自动异常检测功能，帮助用户识别数据中的异常模式。项目旨在降低时间序列分析的门槛，使非专家也能利用先进模型获得可靠的预测结果，适用于业务预测、运维监控、需求规划等场景。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 4045

技术标签

agent agentic-ai anomaly-detection artificial-intelligence deep-learning

使用教程

难度：入门约 10 分钟部署方式：库/依赖 6 步

环境要求

Python 环境（可执行 pip install）
已注册并获取 TimeGPT API Key（README 指向 https://nixtla.io/free-trial）
如需在 Snowflake 内运行，需具备 Snowflake 环境及相应权限

安装与启动步骤

1安装 nixtla SDK

在 Python 环境中安装 Nixtla 官方 SDK，README 要求版本不低于 0.7.0。建议在虚拟环境中安装，避免与其他包冲突。
```
pip install nixtla>=0.7.0
```
2获取 API Key

访问 README 给出的免费试用链接注册并获取 API Key，后续实例化客户端时作为参数传入，不要外泄。
3导入库并实例化客户端

在 Python 中导入 pandas 与 NixtlaClient，用你的 API Key 创建客户端对象；密钥请用真实值替换示例。
```
import pandas as pd
from nixtla import NixtlaClient

nixtla_client = NixtlaClient(api_key='YOUR API KEY HERE')
```
4加载历史数据

读取待预测的历史序列数据（CSV）。README 示例使用电力需求数据，你也可以换成自己的时序文件。
```
df = pd.read_csv('/your/path/electricity.csv')
```
5调用 TimeGPT 预测

按 README 的第 3 步使用已经创建的 nixtla_client 对 df 发起预测请求；完整调用代码请以官网文档为准。
6Snowflake 内部署（可选）

如希望不搬移数据、直接在 Snowflake 中做预测与异常检测，可安装 snowflake 扩展并运行部署脚本。
```
pip install nixtla[snowflake]
python -m nixtla.scripts.snowflake_install_nixtla
```

关键配置

配置项	必填	说明	示例
`api_key`	是	TimeGPT 调用凭证，创建 NixtlaClient 时传入	`YOUR API KEY HERE`
`snowflake 外部访问集成`	否	Snowflake 部署脚本会引导配置，用于访问 TimeGPT	`由脚本交互式配置`