Metadata-Version: 2.4
Name: superinvestor-ai
Version: 0.1.0
Summary: AI-powered quantitative trading agent harness
Project-URL: Homepage, https://github.com/SiluPanda/superinvestor
Project-URL: Repository, https://github.com/SiluPanda/superinvestor
Project-URL: Issues, https://github.com/SiluPanda/superinvestor/issues
Author-email: Silu Panda <31051721+SiluPanda@users.noreply.github.com>
License-Expression: MIT
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Financial and Insurance Industry
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Office/Business :: Financial :: Investment
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: aiosqlite>=0.20
Requires-Dist: anthropic>=0.52
Requires-Dist: apscheduler>=3.10
Requires-Dist: httpx>=0.27
Requires-Dist: pydantic-settings>=2.0
Requires-Dist: pydantic>=2.0
Requires-Dist: textual-plotext>=0.2
Requires-Dist: textual>=0.80
Requires-Dist: typer>=0.12
Provides-Extra: all
Requires-Dist: google-adk>=1.28; extra == 'all'
Requires-Dist: openai-agents>=0.13; extra == 'all'
Provides-Extra: dev
Requires-Dist: pyright>=1.1; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.24; extra == 'dev'
Requires-Dist: pytest>=8.0; extra == 'dev'
Requires-Dist: ruff>=0.8; extra == 'dev'
Provides-Extra: google
Requires-Dist: google-adk>=1.28; extra == 'google'
Provides-Extra: openai
Requires-Dist: openai-agents>=0.13; extra == 'openai'
Description-Content-Type: text/markdown

# Superinvestor

AI-powered quantitative trading agent harness for US equities.

## Features

- **Multi-analyst pipeline** -- parallel AI agents (fundamental, technical, sentiment) analyze stocks independently, then a synthesizer produces a final recommendation
- **Multiple data sources** -- Polygon.io (market data), SEC EDGAR (filings, 13F holdings), FRED (economic indicators)
- **CLI and TUI** -- stream analysis from the command line or explore interactively in the terminal UI
- **Pluggable AI providers** -- Anthropic Claude (primary), with optional OpenAI and Google support
- **Async-first** -- built on httpx, aiosqlite, and Pydantic for fast, typed, concurrent workflows

## Installation

```bash
pip install superinvestor
```

For development:

```bash
git clone https://github.com/SiluPanda/superinvestor.git
cd superinvestor
uv sync --all-extras
```

## Quick Start

Set the required environment variables:

```bash
export SUPERINVESTOR_ANTHROPIC_API_KEY="sk-ant-..."
export SUPERINVESTOR_POLYGON_API_KEY="..."
export SUPERINVESTOR_FRED_API_KEY="..."
```

Run an analysis:

```bash
superinvestor analyze AAPL --stream
```

Launch the terminal UI:

```bash
superinvestor tui
```

### Optional Configuration

| Variable | Description |
|---|---|
| `SUPERINVESTOR_CLAUDE_MODEL` | Override the default Claude model |
| `SUPERINVESTOR_DB_PATH` | Custom SQLite database path |

## Architecture

```
CLI / TUI
    |
    v
Orchestrator
    |
    +---> Fundamental Analyst (AI agent)
    +---> Technical Analyst   (AI agent)
    +---> Sentiment Analyst   (AI agent)
    |
    v
Synthesizer -- merges analyst outputs into a final recommendation
    |
    v
SQLite (analysis history, cached data)
```

Each analyst runs as an independent AI agent with access to its own data sources. The orchestrator dispatches them in parallel and collects their reports. The synthesizer weighs all perspectives and produces a single, structured recommendation.

## Development

```bash
# Run tests
uv run pytest

# Type checking
uv run pyright

# Lint and format
uv run ruff check .
uv run ruff format .
```

Requires Python 3.12+.

## License

[MIT](LICENSE)
