配置文件OAI_CONFIG_LIST + config_api_keys
示例agent_annual_report.ipynb
数据FinnHub / FMP / SEC / yfinance
协议Apache-2.0
配置文件
两个配置文件清单表
这两个文件控制 FinRobot 能否调用模型与数据源。
| 文件 | 改名后 | 填什么 |
|---|---|---|
| OAI_CONFIG_LIST_sample | OAI_CONFIG_LIST | OpenAI API key（LLM 推理） |
| config_api_keys_sample | config_api_keys | FinnHub / FMP / SEC API keys |
分步运行
首次运行四步流程
改名并去注释
把两个 sample 文件重命名，删除文件内的示例注释行。
填入 API Key
在 OAI_CONFIG_LIST 填 OpenAI key；在 config_api_keys 填 FinnHub/FMP/SEC key。
打开 notebook
在 tutorials 目录打开 agent_annual_report.ipynb 或 agent_fingpt_forecaster.ipynb。
运行验证
逐 cell 运行，确认能拉取数据并生成输出（报告/预测）。
示例 notebook
可运行的 tutorial 清单
官方提供入门与进阶 notebook，选一个最小案例先跑通。
| Notebook | 级别 | 作用 |
|---|---|---|
| agent_annual_report.ipynb | 入门 | 生成年报分析 |
| agent_fingpt_forecaster.ipynb | 入门/进阶 | 市场走势预测 |
| agent_trade_strategist.ipynb | 进阶 | 交易策略研究 |
| lmm_agent_mplfinance.ipynb / lmm_agent_opt_smacross.ipynb | 进阶 | 绘图与移动平均交叉优化 |
报错排查
常见报错排查表
| 现象 | 可能原因 | 处理 |
|---|---|---|
| 模型调用报鉴权错误 | OpenAI key 未填或无效 | 检查 OAI_CONFIG_LIST，确认 key 有效且去注释 |
| 数据拉取为空 | FinnHub/FMP key 缺失 | 补填 config_api_keys，或改用 yfinance |
| 依赖导入失败 | 环境未激活 / 未装 -e . | conda activate finrobot 后重跑 pip install -e . |
| Desktop 无法启动 | 非 macOS Apple Silicon | Desktop v0.1.0 仅支持 M 系列 Mac |
常见问题
FinRobot 首次运行常见问题
第一次运行要多久？
取决于数据量、模型与 API 响应；首次拉取财务数据 + LLM 生成报告通常需要几分钟，非秒级。
没有 SEC key 能生成研报吗？
SEC key 主要用于申报文件；生成财报类研报通常需要 FMP，SEC 可按需。
运行结果是投资建议吗？
不是。FinRobot 输出为研究结果，官方 Apache-2.0 免责声明明确不构成投资建议。
跑不通怎么办？
先按上面的报错排查表定位 key/依赖问题；仍不行再看仓库 issue 或官方 Discord。