概述
FinRobot 是 AI4Finance-Foundation 在 GitHub 上开源的一个面向金融应用的 AI Agent 平台，官方全称为“An Open-Source AI Agent Platform for Financial Applications using Large Language Models”。它是一个面向金融决策智能的智能体（agentic）AI 框架，将基础模型与金融工具、量化模型、确定性计算和多智能体工作流结合起来，以构建决策级金融应用。其核心原则是：模型推理、软件计算、智能体编排、系统验证。与 FinGPT 的单模型范式不同，FinRobot 支持面向股票研究、量化交易、风险分析、投资银行、私募股权、财富管理及其他高风险金融决策的端到端智能体工作流。
项目结构
FinRobot 是共享同一个金融领域层的三个项目，各自服务不同用途，并非同一事物的三个相互竞争的版本。
- V2：生产系统，确定性计算引擎、来源追溯（provenance）保证和智能体编排均在此实现。
- V1：股票研究 Web 应用。
- V0：AutoGen 框架版本。通过
pip install finrobot安装的就是 V0 包，其源码已移至finrobot_autogen/，但导入名称未变，所有from finrobot... import ...仍然可用。V0 被保留是因为它足够小、便于阅读和学习。
设计原则：确定性计算 + LLM 叙述
贯穿各代版本的设计原则是：确定性金融计算与基于 LLM 的叙述严格分离。所有金融数字由纯 Python 计算算子生成，而非语言模型。LLM 负责推理、综合、解释和报告撰写；估值输出——DCF、DDM、LBO、WACC、可比公司分析、蒙特卡洛模拟——通过具有完整来源追溯的确定性代码路径计算。
FinRobot Desktop v0.1.0
这是一个由生产级多智能体架构驱动的原生桌面股票研究驾驶舱，将分析师从市场数据和公司文件引导至估值、辩论、综合与投资委员会式报告的单条可追溯工作流。产品中可见的设计原则：DCF 表格标注为“代码计算”——由纯 Python 算子生成的十年预测；旁边的段落则是 LLM 跨三种估值方法对这些数字的解读。
多智能体架构：由 Lead Agent 通过流水线驱动的执行引擎编排专门的研究智能体，包括五个基于角色的子智能体（数据、分析、建模、综合、报告），以及三个辩论智能体（看涨理由、看跌理由、判断）。更多细节见 finrobot_desktop/README.md。
下载与运行：面向 macOS Apple Silicon（M1/M2/M3 或更新），下载 FinRobot_0.1.0_aarch64.dmg 并拖入 Applications。本版本不提供 Intel Mac 构建。该应用尚未经 Apple 公证，首次启动时 macOS 可能提示“已损坏”，需在终端运行一次命令后正常打开。
使用方式
V2 有三种运行同一引擎的方式：
- 桌面应用：下载 release（macOS Apple Silicon）。
- 本地 Web UI：在浏览器中使用同一界面，无需 .dmg 和 Rust 工具链，因此也适用于 Intel Mac、Linux 和 Windows。运行
dev.sh会在 :8321 启动 FastAPI 后端，并在 :5173 启动代理 API 的 Vite 服务器；Ctrl+C 停止两者。注意它会先释放这两个端口，若 FinRobot.app 已打开请先退出；浏览器模式下本地 API 未认证，详情见finrobot_desktop/README.md。 - CLI：在
finrobot_desktop/中执行uv sync后使用。
构建 Tauri 桌面壳见 finrobot_desktop/README.md。
V1（股票研究 Web 应用）：如 deploy.sh 在环境中无法运行，另有可用的两步 CLI 流水线，见 finrobot_equity/README.md。示例报告包括 NVDA、MSFT、TSLA、META、COP。
V0（AutoGen 框架）：
- 创建环境（Python 3.10 或 3.11）。
- 安装——从 PyPI 或仓库根目录源码安装（
setup.py将 finrobot 包映射到finrobot_autogen/finrobot，因此在该目录内安装不可行）。 - 配置密钥——两个文件都放在
finrobot_autogen/，notebook 在此查找它们。请复制而非重命名：*_sample文件被跟踪，填写后的副本被 gitignore。 - 从
finrobot_autogen/tutorials_beginner/或tutorials_advanced/运行教程。
智能体库、工作流类型和完整教程索引见 finrobot_autogen/README.md。
FinRobot Pro
FinRobot Pro 是 AI 驱动的股票研究平台，使用大语言模型和 AI 智能体自动化专业股票分析，网址为 https://finrobot.ai/ 。功能包括：自动化报告生成（按需生成专业股票研究报告）、财务分析（利润表、资产负债表和现金流）、估值分析（P/E、EV/EBITDA 倍数和同行比较）、风险评估（全面的投资风险评估）。
研究基础：四层框架
- 金融 AI 智能体层：包含金融思维链（CoT）提示以强化复杂分析和决策。市场预测智能体、文档分析智能体和交易策略智能体使用 CoT 将金融问题分解为逻辑步骤。
- 金融 LLM 算法层：配置并应用针对特定领域和全球市场分析调优的模型。
- LLMOps 与 DataOps 层：多源集成策略，在一系列先进模型中为每项金融任务选择最合适的 LLM。
- 多源 LLM 基础模型层：支持通用和专用 LLM 的即插即用。
感知—大脑—行动：感知捕获并解释来自市场行情、新闻和经济指标的多模态金融数据并结构化；大脑是核心处理单元，用 LLM 消费感知输出并应用金融 CoT 生成结构化指令；行动用工具执行指令，将分析转化为交易、组合调整、报告或警报。
Smart Scheduler
Smart Scheduler 确保模型多样性并为每项任务选择最合适的 LLM，包含：Director Agent（根据性能指标和任务适配度编排任务分配）、Agent Registration（管理注册并跟踪智能体可用性）、Agent Adaptor（为特定任务定制智能体功能）、Task Manager（存储和管理用于不同金融任务的通用及微调 LLM 智能体，并定期更新）。
适用场景与限制
适用场景：股票研究、量化交易、风险分析、投资银行、私募股权、财富管理等高 stakes 金融决策，以及学习多智能体金融应用开发。
限制与注意：FinRobot Desktop v0.1.0 仅提供 macOS Apple Silicon 构建，不提供 Intel Mac 构建，且尚未经 Apple 公证，首次启动可能提示“已损坏”。浏览器模式下本地 API 未认证。官方明确声明：此处代码和文档按 Apache-2.0 许可发布，不应被视为金融建议或实盘交易推荐，任何交易或投资决策前应谨慎并咨询合格金融专业人士。许可为 Apache 2.0，商标使用见 TRADEMARK_POLICY.md。
