首页 / 开源热榜 / DojoAgents / 使用教程

DojoAgents 中文教程：先用模拟组合检查研究流程

更新于 2026-09-23 · 约 8 分钟

DojoAgents 把跨市场数据、板块、个股和组合视图放进一个本地 Dashboard，再由 Agent Loop 调用工具生成分析。它适合研究和演示。官方说明明确写着：输出可能不准确、不完整或过时，项目不提供投资建议或交易推荐。

当前版本：PyPI、仓库 VERSION 与 pyproject.toml 均为 0.2.7，PyPI 发布日期是 2026-09-20。要求 Python 3.11+；PyPI 包带预构建前端，修改前端源码时才需要 Node.js 18+ 和 npm 9+。

1. 安装发行包

uv venv
source .venv/bin/activate
uv pip install dojoagents
dojoagents dashboard --host 127.0.0.1 --port 8765

打开 http://127.0.0.1:8765/。先绑定本机地址，确认页面与健康状态后再考虑局域网访问。Windows 的虚拟环境激活命令不同，官方 README 分别给了 PowerShell 和 CMD 示例。

2. 配置模型时保护密钥

Dashboard 可配置 OpenAI、Anthropic、Gemini、GLM、DeepSeek，也可改用 Ollama、llama.cpp 或 vLLM 等本地兼容端点。README 说明界面里的 key 和 endpoint 会写入 ~/.dojo/agents.yaml。给这个文件设置仅当前用户可读权限，不要把它同步进 Git、网盘或截图。

3. 从一份虚构组合开始

用几只虚构持仓检查完整链路：市场数据是否带时间戳，工具步骤能否展开，组合归类是否正确，同一问题重复运行会不会出现明显冲突。截图识别尤其容易读错代码、数量和币种，真实账户截图还可能包含姓名、账号和资产信息，所以教程不建议上传真实截图。

金融边界：模型会写出像投资建议的句子，但它没有受托责任，也无法保证行情、公司行为和汇率已经更新。不要把输出直接交给券商或自动交易程序；任何仓位决定都要回到交易所公告、公司披露和券商原始记录。

4. 何时需要源码构建

只想运行 Dashboard，不用编译 React。需要改界面时，再克隆仓库、执行 uv pip install -e ".[dev]"，进入 dojoagents/dashboard/web 运行 npm install 与 npm run build。当前 GitHub Releases 页面为空，版本应以 PyPI、VERSION 和 pyproject 的一致记录为准。

与 ai-hedge-fund 对比

virattt/ai-hedge-fund 以可保存的 fund mandate、投资者 Agent 和历史回测为主，官方也说明当前不会实际交易。DojoAgents 更偏向跨市场 Dashboard、组合诊断、金融 Harness 与可替换会话存储。想验证策略组合和回测流程，可先看 ai-hedge-fund；想开发研究面板、数据工具和自定义金融场景，DojoAgents 的结构更合适。

验证状态：本轮只核对官方 README、VERSION、pyproject.toml、GitHub Releases 和 PyPI 0.2.7 页面；没有安装包、启动 Dashboard、配置模型、调用市场数据或验证任何投资分析。

这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。

先判断这个项目是否适合你

适合谁用

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

采用建议

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

原教程未展开的系统信息

核心功能

  • 跨市场研究 Dashboard

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

  • Agent Loop 与金融 Harness

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

架构与数据流

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

技术栈和运行条件

语言

Python 3.11+；React/TypeScript 前端

框架

FastAPI、Uvicorn、Vite、Agent Loop/Harness

关键依赖

  • openai >=1.20,<2
  • fastapi >=0.115.2,<0.116
  • mcp >=1.26,<2
  • strands-agents
  • dojosdk >=0.1.23

运行环境

uv；一个模型 API key 或本地兼容端点；源码前端构建需要 Node.js 18+ 与 npm 9+

常见问题

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 安装与构建。

官方来源：DojoAgents 仓库、VERSION、pyproject.toml、GitHub Releases、PyPI 0.2.7；对比来源：ai-hedge-fund 官方仓库。