Alpha-Dojo/DojoAgents

DojoAgents – AI 驱动的个人投资助手

DojoAgents 是一个开源框架，允许个人投资者在自己的机器上运行一个 具备投资组合意识的 AI 代理。核心是一个 代理循环，它协调大型语言模型（OpenAI、Gemini、Anthropic 等）与一系列金融专用工具（市场数据获取器、新闻抓取器、技术指标计算器、Python沙箱等）。该代理能够分析多个市场（美国、香港、A股），跟踪用户的持仓，并生成多步骤分析，例如每日市场概览、新闻影响评估，或从投资组合截图中进行风险诊断。

主要组件

组件	功能
代理循环引擎	运行 LLM，决定调用哪个工具，压缩上下文，并强制执行防护机制以避免“金融幻觉”。
执行沙箱	用于实时计算（如技术指标）和网络爬取的隔离 Python 环境。
记忆与技能	将成功的多步骤工作流存储为可重用的“技能”，供代理后续调用。
定时任务与网关	安排自动化洞察，并推送至聊天平台（Slack、Telegram、Discord、微信等）。
FastAPI 后端 + React SPA 仪表板	提供一个 Web UI，用户可查看投资组合指标、市场热力图、行业树，并通过聊天与代理互动。

可以实现的功能

每日市场概览 – 询问“今天值得关注什么？”，代理将收集跨市场动向、行业轮动和价格/成交量变化，并展示其调用的每个工具。
新闻影响分析 – 输入一则新闻标题（例如：Meta 的 AI 基础设施布局），即可获得受其影响的美国和 A 股股票清单，并附上支持数据。
从截图诊断投资组合 – 上传一份持仓列表截图；多模态模型将提取股票代码，分组并标记集中度过高或缺失防御性资产的问题。
模拟再平衡 – 诊断后，代理会建议交易，创建“如果……会怎样”的投资组合，并在仪表板中跟踪其表现。

快速开始（来自 README）

# 1. 使用 uv（推荐）创建虚拟环境并安装包
uv venv && source .venv/bin/activate
uv pip install dojoagents   # 拉取已发布的 wheel 包

# 2. （可选）从源码构建 Web UI
cd dojoagents/dashboard/web
npm install && npm run build

# 3. 运行服务器
dojoagents dashboard --host 127.0.0.1 --port 8765

在浏览器中打开显示的 URL，然后在设置面板中配置您的 LLM API 密钥（支持 OpenAI、Anthropic、Gemini、Zhipu GLM、DeepSeek 或任何本地端点，如 Ollama）。UI 是一个与 FastAPI 后端通过 OpenAI 兼容聊天端点和 Server-Sent Events 实时图表更新通信的 React SPA。

可扩展性

自定义钩子 – 框架将 金融钩子（提示、工具、策略）与通用运行时分离。开发者可提供自己的钩子 YAML 或 Python 工厂，以扩展至其他领域。
插件 / 技能 – 添加新数据源，编写基于 Python 的指标函数，或创建代理可自动调用的可重用多步骤分析脚本。
全渠道网关 – 将代理接入 Slack、Discord、微信、飞书、邮件等，实现定时简报推送。

许可与免责声明

DojoAgents 采用 Apache 2.0 许可证发布。作者强调，该软件仅用于 教育和研究目的，不构成投资建议；用户需自行承担所有交易决策的风险。

总结：DojoAgents 是一个真正的端到端 AI 代理平台，结合了 LLM 推理、工具编排和精美的金融仪表板，为零售投资者提供机构级分析助手。它完全开源、可扩展，可使用您偏好的任何 LLM 提供商在本地运行。