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
| Phase | Agent | Role |
|---|---|---|
| ๐ Intelligence | Market Analyst | Technical analysis, price action, volume patterns |
| ๐ Intelligence | Social Analyst | Social media sentiment, retail trader mood |
| ๐ Intelligence | News Analyst | Breaking news, SEC filings, macro events |
| ๐ Intelligence | Fundamentals Analyst | Revenue, P/E, balance sheet, cash flow |
| ๐ฅ Debate | Bull Researcher | Makes the bullish case with evidence |
| ๐ฅ Debate | Bear Researcher | Makes the bearish case with evidence |
| ๐ฅ Debate | Aggressive Debater | Pushes for high-conviction trades |
| ๐ฅ Debate | Conservative Debater | Argues for caution and risk management |
| ๐ฅ Debate | Neutral Debater | Weighs both sides objectively |
| โก Decision | Trader | Proposes the trade (buy/hold/sell, size, timing) |
| ๐ก๏ธ Risk | Risk Manager | VETO POWER โ can block any trade |
| ๐ฏ Final | Investment Judge | Final 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