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 提供商在本地運行。