DojoAgents: Full-Market AI Copilot for Personal Investment

<div align="center">
    <picture>
    <source
      media="(prefers-color-scheme: dark)"
      srcset="dojoagents/dashboard/web/src/assets/images/logo.svg"
    />
    <source
      media="(prefers-color-scheme: light)"
      srcset="dojoagents/dashboard/web/src/assets/images/logo-dark.svg"
    />
    <img
      alt="DojoAgents Logo"
      src="dojoagents/dashboard/web/src/assets/images/logo.svg"
      width="320"
    />
  </picture>
</div>

<p align="center">
  <a href="https://discord.gg/CCRvSvdvr"><img src="https://img.shields.io/badge/Discord-DojoAgents-5865F2?logo=discord&logoColor=white" alt="Discord"></a>
  <a href="docs/site/en/community/wechat.md"><img src="https://img.shields.io/badge/WeChat-DojoAgents-4CB55E?logo=wechat&logoColor=white" alt="WeChat"></a>
  <a href="https://huggingface.co/AlphaDojo"><img src="https://img.shields.io/badge/HuggingFace-DojoAgents-FFD21E?logo=huggingface&logoColor=000000" alt="HuggingFace"></a>
  <a href="https://github.com/Alpha-Dojo/DojoAgents/blob/main/docs/README.md"><img src="https://img.shields.io/badge/Join%20GitHub%20Community-DojoAgents-2ea44f?logo=github&logoColor=white" alt="GitHub Community"></a>
</p>

---

# DojoAgents: Full-Market AI Copilot for Personal Investment

DojoAgents is a full-market AI agent framework designed specifically for personal investment. Built to bridge the gap between individual investors and institutional-grade tools, its true powerhouse is a state-of-the-art Agent Loop engine. Instead of a simple dashboard, DojoAgents deploys an autonomous reasoning agent that lives alongside your portfolio, handling everything from full-market data cognition to dynamic cross-market strategy deduction.

<div align="center">
  <img
    alt="DojoAgents system architecture diagram"
    src="docs/site/assets/images/structure.png"
    width="720"
  />
  <p><em>Seven-layer architecture — from CLI, Web Dashboard, and Chat Gateways through Agent Loop to tools, data, and infrastructure.</em></p>
</div>

## ✨ Why DojoAgents?

**🧠 Loop-Driven Cognitive Portfolio Agent (Our Core Engine):** Most financial AI tools are built for quick outputs: news summaries, single-stock explanations, basic indicator readings, or generic market commentary. Our Loop-Driven Cognitive Portfolio Agent is built for portfolio-aware reasoning, connecting your holdings with market data and running structured analysis across four dimensions:
* **Fundamental Data Cognition:** Instantly fetches, structures, and cross-references raw multi-market data (K-lines, financials, news).
* **Advanced Logic Analysis:** Interprets valuation bands, momentum indicators, and sector taxonomy to uncover hidden market mechanics.
* **Cross-Market Strategy Deduction:** Formulates macro asset allocation and maps market linkages (e.g., autonomously reasoning through *"Why US semiconductor software dropped while A-shares surged"* via multi-step tool execution).
* **Dynamic Portfolio Management:** Continuously diagnoses risk exposure, monitors net-worth curves, and evaluates performance attribution to support more informed rebalancing decisions.

**📊 Four-Pillar Dashboard:** An out-of-the-box, institutional-grade React SPA featuring:
- **Portfolio (The Command Center):** Net worth curves, live risk exposure, and smart position tracking.
- **Markets:** Cross-market heatmaps (US/HK/A-shares) and index tracking.
- **Sectors:** Deep-dive L1/L2/L3 taxonomy and momentum curves.
- **Equities:** K-lines, PE bands, financials, and news—all in one unified view.

**🤖 Autonomous Quant Analyst:** Powered by multi-agent collaboration, it autonomously conducts background market research, tracks sector rotations, and monitors your risk exposure while you sleep.

**📱 Planned Omnichannel Updates:** Future versions will support personalized daily briefings and alert notifications through Slack, Telegram, Discord, Feishu, WeChat, or email.

## 📈 What DojoAgents Can Do

### 1. Daily Market Overview

*"What's worth watching in global markets today?"* — one of the most common questions investors ask every morning. Behind it lies cross-market moves, sector rotation, stock anomalies, sentiment, and potential catalysts.

DojoAgents enters a data-gathering phase, calling global market, sector, and equity tools to pull movers, strength rankings, price changes, volume shifts, and sector distribution across A-shares, US equities, and HK stocks. Throughout the run, expand any intermediate step to see which tools were invoked, what data was cited, and how the analysis progressed.

<div align="center">
  <img
    alt="DojoAgents daily market overview demo"
    src="docs/site/assets/gifs/market_overview.gif"
    width="720"
  />
</div>

### 2. News Impact Analysis

When breaking news hits, the first question is always: *which stocks will be affected?*

Take Meta's recent AI infrastructure moves — A-share investors naturally asked: *"Meta selling compute capacity — which US and A-share stocks could be impacted?"* DojoAgents decomposes the q

... (truncated)