README.md

March 24, 2026 ยท View on GitHub

๐Ÿค– AI Quant Fund โ€” Multi-Agent Live Trading Analysis

12 AI Agents. 1 Ticker. Real-Time Debate. Consensus Decision.


What is this?

AI Quant Fund is a multi-agent trading analysis system where 12 specialized AI agents debate and analyze stocks in real-time โ€” just like a Wall Street trading floor, but powered entirely by AI.

You enter a ticker โ†’ 12 AI agents activate โ†’ They debate โ†’ You get a consensus

The 12 Agents

PhaseAgentRole
๐Ÿ“Š IntelligenceMarket AnalystTechnical analysis, price action, volume patterns
๐Ÿ“Š IntelligenceSocial AnalystSocial media sentiment, retail trader mood
๐Ÿ“Š IntelligenceNews AnalystBreaking news, SEC filings, macro events
๐Ÿ“Š IntelligenceFundamentals AnalystRevenue, P/E, balance sheet, cash flow
๐Ÿ”ฅ DebateBull ResearcherMakes the bullish case with evidence
๐Ÿ”ฅ DebateBear ResearcherMakes the bearish case with evidence
๐Ÿ”ฅ DebateAggressive DebaterPushes for high-conviction trades
๐Ÿ”ฅ DebateConservative DebaterArgues for caution and risk management
๐Ÿ”ฅ DebateNeutral DebaterWeighs both sides objectively
โšก DecisionTraderProposes the trade (buy/hold/sell, size, timing)
๐Ÿ›ก๏ธ RiskRisk ManagerVETO POWER โ€” can block any trade
๐ŸŽฏ FinalInvestment JudgeFinal verdict after all debates

How It Works

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”    โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚ INTELLIGENCE โ”‚ โ†’  โ”‚    DEBATE    โ”‚ โ†’  โ”‚   TRADING   โ”‚ โ†’  โ”‚   DECISION   โ”‚
โ”‚              โ”‚    โ”‚              โ”‚    โ”‚             โ”‚    โ”‚              โ”‚
โ”‚ 4 Analysts   โ”‚    โ”‚ Bull vs Bear โ”‚    โ”‚ Trader      โ”‚    โ”‚ Risk Manager โ”‚
โ”‚ gather data  โ”‚    โ”‚ 3 Debaters   โ”‚    โ”‚ proposes    โ”‚    โ”‚ Judge rules  โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜    โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

Quick Start

Install

pip install ai-quant-agents

Usage โ€” 3 Lines of Code

from ai_quant_agents import QuantClient

client = QuantClient()  # connects to wss://dream.hmyk.ai/ws/live

# Analyze any US stock or China A-share
result = client.analyze("NVDA")
print(result.decision)    # "BUY" / "HOLD" / "SELL"
print(result.confidence)  # 0.85
print(result.consensus)   # {"buy": 8, "hold": 3, "sell": 1}

Live Streaming โ€” Watch Agents Debate

from ai_quant_agents import QuantClient

client = QuantClient()

# Stream real-time agent messages
for msg in client.stream("TSLA"):
    print(f"[{msg.speaker}] {msg.message}")
    # [Market Analyst] TSLA showing bullish divergence on RSI...
    # [Bear Researcher] However, delivery numbers missed by 12%...
    # [Risk Manager] Position size should not exceed 3% of portfolio...

China A-Share Support ๐Ÿ‡จ๐Ÿ‡ณ

result = client.analyze("600519")          # ่ดตๅทž่Œ…ๅฐ
result = client.analyze("000001")          # ๅนณๅฎ‰้“ถ่กŒ
result = client.analyze("ๆฏ”ไบš่ฟช")           # Chinese name supported

Example Output

{
  "ticker": "NVDA",
  "decision": "BUY",
  "confidence": 0.85,
  "consensus": {"buy": 8, "hold": 3, "sell": 1},
  "risk_approved": true,
  "key_reasons": [
    "Strong data center revenue growth +120% YoY",
    "Blackwell GPU demand exceeding supply",
    "Institutional accumulation detected"
  ],
  "risk_warnings": [
    "Valuation stretched at 45x forward P/E",
    "China export restrictions uncertainty"
  ],
  "suggested_action": {
    "entry": "\$142-145",
    "stop_loss": "\$132",
    "target": "\$165",
    "position_size": "2-3% of portfolio"
  }
}

๐Ÿ”ด Try the Full Live Experience

The demo SDK gives you the analysis result. But the real magic is watching 12 agents debate in real-time in our cyberpunk trading room:


๐Ÿ‘† Click to enter the Live Trading Room โ€” Free to try

What you get in the full version:

  • ๐Ÿ”ด Real-time streaming debate (watch agents think out loud)
  • ๐Ÿ“Š Live market data ticker (US + China A-shares)
  • ๐ŸŽฏ Historical analysis archive
  • ๐Ÿ“ฑ Mobile responsive UI
  • ๐ŸŒ English + Chinese bilingual

Architecture

Built on TradingAgents (Apache 2.0) by Tauric Research.

Extended with:

  • China A-share market support (Tushare data)
  • Real-time WebSocket live streaming
  • Hybrid LLM (GPT + Gemini) for speed + depth
  • Cyberpunk UI trading room

Disclaimer

โš ๏ธ NFA โ€” Not Financial Advice. This tool is for research and entertainment purposes only. AI analysis should not be used as the sole basis for investment decisions. Always do your own research. Past performance does not guarantee future results.


License

Apache License 2.0 โ€” See LICENSE for details.

Built with โค๏ธ by DEMAND AI