DojoAgents 是什么?

DojoAgents 是 Alpha-Dojo 开发的开源个人投资研究 Agent 框架。它把市场、板块、个股和模拟组合数据放进 FastAPI/React Dashboard,并由 Agent Loop 调用工具生成分析过程。官方明确限定为教育、研究与演示用途。

⭐ 300 Stars 🍴 23 Forks Python Apache-2.0 作者: Alpha-Dojo
来源:github.com/Alpha-Dojo/DojoAgents;https://pypi.org/project/dojoagents/ 查看 GitHub 仓库 → 📘 使用教程 →

为什么值得关注

PyPI 在 2026-09-20 发布 0.2.7;当前 README 补充了 Harness Runtime、会话存储适配和可直接安装的预构建 Dashboard。

来源:pypi.org/project/dojoagents/;https://github.com/Alpha-Dojo/DojoAgents

核心功能

跨市场研究 Dashboard

界面覆盖组合、市场、板块和个股视图,后端通过 OpenAI 兼容聊天 API 与 SSE 返回分析和图表。

来源:github.com/Alpha-Dojo/DojoAgents
Agent Loop 与金融 Harness

核心负责模型循环、工具、会话与生命周期;内置 financial Harness 管理提示、策略、数据工具、记忆和结果展示。

来源:github.com/Alpha-Dojo/DojoAgents
自备模型与自定义端点

设置页支持 OpenAI、Anthropic、Gemini、GLM、DeepSeek,也可指定 Ollama、llama.cpp 或 vLLM 等本地端点。

来源:github.com/Alpha-Dojo/DojoAgents

技术架构

Python Core 运行 Agent Loop、工具与按 tenant/user/session 隔离的会话;financial Harness 定义金融场景;FastAPI Dashboard 负责 API、存储和刷新任务,React/Vite 前端用 SSE 接收结果。默认包带预构建前端,只有源码改前端才需要 Node.js。

来源:github.com/Alpha-Dojo/DojoAgents;https://github.com/Alpha-Dojo/DojoAg…

项目知识图谱

知识图谱:项目核心节点(中心)+ 核心功能(内环六边形)+ 关键技术依赖(外环 chip) openai >=1.20,<2openai >=1.20,… fastapi >=0.115.2,<0.116fastapi >=0.11… mcp >=1.26,<2 strands-agents dojosdk >=0.1.23dojosdk >=0.1.… 跨市场研究 Dashboard Agent Loop 与金融 HarnessAgent Loop 与金融 H… 自备模型与自定义端点 DojoAgents 项目本体 核心功能 关键依赖

技术栈

语言Python 3.11+;React/TypeScript 前端框架FastAPI、Uvicorn、Vite、Agent Loop/Harness
openai >=1.20,<2fastapi >=0.115.2,<0.116mcp >=1.26,<2strands-agentsdojosdk >=0.1.23
uv;一个模型 API key 或本地兼容端点;源码前端构建需要 Node.js 18+ 与 npm 9+
来源:github.com/Alpha-Dojo/DojoAgents/blob/main/pyproject.toml;https://git…

快速上手

准备 Python 3.11+ 和 uv,建立虚拟环境后运行 uv pip install dojoagents,再以 dojoagents dashboard --host 127.0.0.1 --port 8765 启动。浏览器打开本机 8765 端口,在 Settings 中配置自己的模型 provider 或本地端点。先使用虚构或脱敏组合,不要上传真实账户截图。
来源:github.com/Alpha-Dojo/DojoAgents;https://pypi.org/project/dojoagents/

使用场景

适合学习多工具金融 Agent、整理跨市场信息、检查模拟组合暴露和开发自定义研究技能。输出可能不准确、不完整或过时,不能当作交易指令,也不应让它自动接管真实账户。

来源:pypi.org/project/dojoagents/;https://github.com/Alpha-Dojo/DojoAgents

优势与局限

优势

  • 市场、板块、个股与组合集中在一个 Dashboard
  • Harness 把场景策略与核心运行时分开
  • 预构建 PyPI 包无需手动编译前端

局限

  • 需要用户自备模型服务或本地端点
  • 模型输入、市场数据与分析都可能存在时效和准确性问题
  • API key 默认写入本机 ~/.dojo/agents.yaml,需要保护文件权限
  • 投资输出只适合教育研究,不能作为交易建议
  • 本轮没有安装、启动或验证金融数据
来源:github.com/Alpha-Dojo/DojoAgents;https://pypi.org/project/dojoagents/

最新版本

当前包版本是 0.2.7,PyPI 记录发布于 2026-09-20;仓库 VERSION 与 pyproject.toml 一致。GitHub Releases 页面没有 release,因此不能把 PyPI 发布误写成 GitHub Release。

来源:pypi.org/project/dojoagents/;https://github.com/Alpha-Dojo/DojoAgents…

实测与证据

status: official_docs_checked_not_run  |  checked_at: 2026-09-23  |  environment: 核对 Alpha-Dojo/DojoAgents 官方 README、VERSION、pyproject.toml、GitHub Releases 与 PyPI 0.2.7 页面  |  limitations: 未安装 PyPI 包、未启动 Dashboard、未配置模型 key、未调用市场数据,也未验证分析结果  |  observed_output: VERSION 与 pyproject.toml 均为 0.2.7;PyPI 记录 2026-09-20 发布并要求 Python >=3.11;GitHub Releases 页面没有发行记录

来源:github.com/Alpha-Dojo/DojoAgents/blob/main/VERSION;https://github.com…

同类项目对比

virattt/ai-hedge-fund 以可保存的 fund mandate、投资者 Agent 和回测循环为主,官方同时说明当前不实际交易;DojoAgents 更偏跨市场 Dashboard、组合诊断、金融 Harness 与可扩展会话后端。想研究策略组合与回测可先看 ai-hedge-fund,想搭可扩展的研究面板和工具运行时可评估 DojoAgents。

来源:github.com/virattt/ai-hedge-fund;https://github.com/Alpha-Dojo/DojoAg…

总结评价

DojoAgents 可用于学习金融 Agent 编排和搭建个人研究面板。先在脱敏、模拟数据上检查来源、时间戳和重复运行结果;任何仓位调整都应回到原始数据并由人独立判断。

来源:github.com/Alpha-Dojo/DojoAgents;https://pypi.org/project/dojoagents/

常见问题

DojoAgents 0.2.7 需要什么运行环境?

PyPI 包要求 Python 3.11+。直接安装预构建包不需要 Node.js;修改并构建前端才需要 Node.js 18+ 和 npm 9+。

DojoAgents 会自动执行真实交易吗?

官方将项目限定为教育、研究和演示用途,并声明不提供投资建议或交易推荐。本文也不提供接入真实券商账户的步骤。

DojoAgents 的 API key 存在哪里?

README 说明在界面中填写的 key 和端点配置写入本机 ~/.dojo/agents.yaml。应限制文件权限且不要提交到仓库。

安装 DojoAgents 后还要手动构建 React Dashboard 吗?

通过 PyPI 安装的当前包自带预构建前端,可直接启动 Dashboard。从源码修改前端时才运行 npm 安装与构建。

资料与核验范围
本文依据项目公开资料整理。版本、安装命令和功能边界可能随上游更新,请以所列来源和项目当前版本为准。 资料核对时间: 2026-09-23 13:55.

参考材料:README、GitHub API、依赖文件