源码安装
git clone + pip install -e .，适合二次开发与跑 tutorial notebook。
FinRobot 安装部署 / AI4Finance-Foundation
FinRobot 安装部署：conda 环境、依赖与 API Key 配置
FinRobot 官方提供 conda 环境 + pip 源码/PyPI 两种安装方式，安装本身不复杂，真正的前置成本在「配置多个 API Key」（OpenAI + 数据源）。
1. conda 建环境python=3.10
2. 克隆仓库git clone
3. pip 装包finrobot / -e .
4. 配 API KeyOpenAI + 数据源
环境conda + Python 3.10
安装pip install -U finrobot / -e .
API KeyOpenAI / FinnHub / FMP / SEC
协议Apache-2.0
前置依赖
FinRobot 安装前置依赖对照表
先备齐环境与账号，安装才不会卡在 API Key。
| 依赖 | 要求 | 说明 |
|---|---|---|
| Python | 3.10（conda） | 官方推荐 conda 建独立环境，避免依赖冲突 |
| OpenAI API Key | 必填 | 写入 OAI_CONFIG_LIST（用于 LLM 推理） |
| FinnHub API Key | 必填 | 写入 config_api_keys（行情/新闻数据） |
| FMP API Key | 报表生成时必填 | 财务数据（三大报表） |
| SEC API Key | 报表生成时必填 | SEC 公告/申报文件 |
分步安装
FinRobot 安装六步流程
创建环境
conda create --name finrobot python=3.10然后conda activate finrobot。克隆仓库
git clone https://github.com/AI4Finance-Foundation/FinRobot.git然后cd FinRobot。安装依赖
从 PyPI：
pip install -U finrobot；或从源码：pip install -e .。配置 OpenAI Key
把 OAI_CONFIG_LIST_sample 改名为 OAI_CONFIG_LIST，填入你的 OpenAI API key。
配置数据源 Key
把 config_api_keys_sample 改名为 config_api_keys，填入 FinnHub / FMP / SEC 的 key。
跑教程验证
在 tutorials 里打开 agent_annual_report.ipynb 等 notebook 验证环境。
安装路径
三种使用路径对比
根据你的目标选择：纯研究用源码、快速体验用 PyPI、桌面端只有 macOS。
PyPI 安装
pip install -U finrobot，快速引入核心包，适合集成到自己脚本。
Desktop 桌面端
FinRobot Desktop v0.1.0，仅支持 macOS Apple Silicon，非 Windows/Linux。
适用人群
谁适合自建 FinRobot？
如果你只是想要一个「研究结论」，自建的成本可能高于收益。
适合
有 Python 基础、想复现多智能体研究管道、愿意维护多个 API key 的开发者/研究者。
不适合
只想查一次行情/估值/技术面的普通用户，装环境与配 key 门槛偏高。
备选
可直接用 EasyClaw 量化研究 Skill 一句话出结果，免去环境与 key 配置。
常见问题
FinRobot 安装常见问题
FinRobot 必须用 conda 吗？
官方推荐 conda 建独立环境（python=3.10）避免冲突，也可用 venv，但需确保 Python 版本兼容。
没有 API Key 能跑吗？
核心 LLM 推理需要 OpenAI key，数据获取需要 FinnHub/FMP 等 key；缺 key 会无法跑通完整流程。
FinRobot 支持 Windows 吗？
源码/PyPI 方式理论支持跨平台；但 Desktop 桌面端 v0.1.0 仅支持 macOS Apple Silicon。
安装报依赖冲突怎么办？
优先用独立 conda 环境重装；升级 pip 后再 pip install -e .，详见首次运行页的排查表。