docs

Documentation

Contents

Document	Description
Architecture	System design, agent pipeline, state management, Mermaid diagrams
Usage Guide	Installation, Streamlit dashboard, CLI, data sources, troubleshooting
Configuration	All environment variables, recommended settings per use case

Architecture at a Glance

flowchart TD
    START([Start]) --> FD[Fetch Market Data]
    FD --> AN[Run Analysts<br/>parallel]
    AN --> RD[Bull vs Bear Debate]
    RD --> TD[Trader Decision]
    TD --> RR[Risk Review]
    RR --> VR[Verification]
    VR --> END([Final Decision])

Loading

9 Agents: Fundamental Analyst, Sentiment Analyst, News Analyst, Technical Analyst, Bull Researcher, Bear Researcher, Trader, Risk Manager, Verifier

4 Free Data Sources: Yahoo Finance, Google News, SEC EDGAR, Google Trends

3 LLM Providers: Ollama (local), LM Studio (local), OpenAI (cloud)

2 Interfaces: Streamlit visual dashboard, Rich CLI

See Architecture for full details with data flow diagrams.

Quick Start

cd opentrade-ai
python -m venv venv && source venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env

# Streamlit
python -m streamlit run app/streamlit_app.py

# CLI
python -m cli.main -t AAPL -p lmstudio

See Usage Guide for detailed setup instructions.