AI-powered market intelligence platform with autonomous multi-agent analysis, portfolio tracking, and pattern recognition.
- Autonomous 6-Phase Analysis -- Scans macro conditions, rotates sectors, hunts opportunities, deep-dives candidates, evaluates coverage, and synthesizes insights
- Multi-Agent Deep Analysis -- Five specialist analysts (Macro Economist, Sector Strategist, Technical Analyst, Risk Analyst, Correlation Detective) run in parallel, aggregated by a Synthesis Lead
- Portfolio Tracking -- Holdings CRUD with live prices, insight impact analysis, and portfolio-aware discovery
- Pattern Recognition -- LLM-based extraction of repeatable trading patterns with automatic deduplication and quality validation
- Prediction Track Record -- Outcome tracking, monthly trend analysis, and pattern success rate feedback loops
- Research Hub -- Spawn follow-up research from conversations with background execution and provenance linking
- Published Reports -- Self-contained HTML reports auto-published to GitHub Pages
- Runs Analytics Dashboard -- View past analysis runs with per-phase metrics: token usage, cost tracking, timing, and success rates
- Real-Time Chat -- WebSocket-based conversational analysis with 10 market data tools
- 7 LLM Providers -- Anthropic, Bedrock, Vertex, Azure, z.ai, Ollama, Claude Code subscription
- Desktop App -- Native packaging via Tauri v2 with CI builds for macOS and Windows
Download the latest desktop app from Releases:
- macOS:
Teletraan_x.x.x_aarch64.dmg(Apple Silicon) or_x64.dmg(Intel) - Windows:
Teletraan_x.x.x_x64-setup.msi
Or run from source -- see Quick Start.
- Python 3.11+ with
uv - Node.js 18+ with
npm
git clone https://github.com/barkain/teletraan.git
cd teletraan
./start.shThis installs all dependencies, creates .env files, starts both services, and opens your browser.
Frontend: http://localhost:3000
API Docs: http://localhost:8000/docs
Custom ports:
BACKEND_PORT=8001 FRONTEND_PORT=3001 ./start.sh
FastAPI backend (Python) + Next.js 16 frontend (TypeScript/React 19) with SQLite storage, Claude Agent SDK for multi-agent LLM orchestration, and data from Yahoo Finance, FRED, and Finnhub.
See docs/architecture.md for the full system diagram, pipeline details, and project structure.
| Topic | Link |
|---|---|
| Architecture | docs/architecture.md |
| LLM Providers | docs/llm-providers.md |
| Publishing Reports | docs/publishing.md |
| Desktop App | docs/desktop-app.md |
| Development Guide | docs/development.md |
Additional references:
- CLAUDE.md -- Developer guidance: architecture patterns, commands, key modules
- Swagger UI -- Interactive API docs at
http://localhost:8000/docswhen running
Teletraan is licensed under the MIT License. See LICENSE for details.
Built with FastAPI, Next.js, and Claude Agent SDK