How edison-vs-tesla/ai-hedge-fund works
This repository combines an LLM-driven equity analysis and trading system with a visual flow-building web app. The primary trading workflow runs analyst signals through risk sizing and portfolio decisions, then optionally executes through a broker; the daemon adds price-driven watch and escalation stages. Separate capabilities include historical backtesting, quant research, and universe selection. The graph follows README-documented integration points and the sampled workflow code; unsampled service internals are represented only where paths are supported, and uncertain wiring is omitted.
Main entry points: run_cycle.py Trading cycle · main.py Agent workflow · scheduler.py Trading daemon · flows.py Flow routes
Components 30
Trading runtime
- Alpaca CLI
integrations/alpaca/cli.py - Trading daemon
integrations/alpaca/scheduler.py - Trading cycle
integrations/alpaca/run_cycle.py - Light cycle
integrations/alpaca/light_cycle.py - Analyst agents
src/agents - Agent workflow
src/main.py - Risk sizing
src/agents/risk_manager.py - Portfolio decisions
src/agents/portfolio_manager.py
Market integrations
- Broker protocol
integrations/broker/protocol.py - Alpaca broker
integrations/alpaca/broker.py - Composite data
integrations/data/composite.py - Data API bridge
integrations/data/v1_bridge.py - Market providers
- Cycle ledger
integrations/alpaca/ledger.py - Scheduler state
integrations/alpaca/session.py
Research tools
- Agent backtesting
src/backtesting/engine.py - PEAD quant stack
v2/signals/pead.py - Quant backtesting
v2/backtesting/engine.py - Earnings event study
v2/event_study/engine.py - Universe builder
integrations/universe/pipeline.py
Flow web app
- Flow editor
app/frontend/src/components/Flow.tsx - Frontend API
app/frontend/src/services/api.ts
Web backend
- Backend API
app/backend/main.py - Flow routes
app/backend/routes/flows.py - Flow repository
app/backend/repositories/flow_repository.py - Application database
app/backend/database/connection.py - Flow agent service
app/backend/services/agent_service.py - Backtest service
app/backend/services/backtest_service.py
Other components
- Trader
- Web user
Connections 30
- Trader → Alpaca CLI: invokes
- Alpaca CLI → Trading daemon: starts daemon
- Alpaca CLI → Trading cycle: runs cycle
- Trading daemon → Light cycle: escalates
- Trading daemon → Trading cycle: runs heavy cycle
- Trading cycle → Agent workflow: runs agents
- Agent workflow → Analyst agents: dispatches
- Agent workflow → Risk sizing: dispatches
- Risk sizing → Portfolio decisions: passes limits
- Agent workflow → Portfolio decisions: dispatches
- Risk sizing → Data API bridge: fetches prices
- Data API bridge → Composite data: requests data
- Composite data → Market providers: fetches market data
- Trading cycle → Broker protocol: submits trades
- Broker protocol → Alpaca broker: dispatches
- Trading cycle → Cycle ledger: records cycle
- Trading daemon → Scheduler state: tracks session
- Trader → Agent backtesting: runs backtest
- Agent backtesting → Agent workflow: runs daily analysis
- Quant backtesting → PEAD quant stack: queries signals
- Earnings event study → Market providers: requests prices
- Universe builder → Market providers: enriches candidates
- Web user → Flow editor: edits flows
- Flow editor → Frontend API: requests operations
- Frontend API → Backend API: sends requests
- Backend API → Flow routes: dispatches
- Flow routes → Flow repository: reads and writes
- Flow repository → Application database: persists flows
- Flow routes → Flow agent service: invokes
- Flow routes → Backtest service: invokes