POLYDESK

POLYDESK is an institutional-grade browser platform for Polymarket research, analytics, thesis management, and controlled execution.

Monorepo

• apps/web: Next.js operator workstation
• services/api: FastAPI control plane and UI backend
• services/analytics: Quant analytics engines
• services/ingestor: Market data and research ingestion
• services/executor: Replay, paper, and live Polymarket execution
• services/llm-orchestrator: Model registry, routing, tools, and thesis workflows
• packages/*: shared TypeScript contracts, UI, and client code

Runtime Defaults

• Frontend: Next.js + TypeScript
• Backend: FastAPI + Pydantic v2 + SQLAlchemy 2
• Analytics: Polars, NumPy, SciPy, statsmodels, scikit-learn
• Storage: PostgreSQL + TimescaleDB, Redis
• Execution: replay, paper, and live Polymarket under deterministic risk controls

Quick Start

1. Copy .env.example to .env.
2. Start infrastructure with Docker Compose.
3. Install workspace dependencies with npm install and Python dependencies with uv sync.
4. Run npm run dev for the web app and uv run polydesk-api for the API.

See docs/architecture/overview.md for the system design and docs/runbooks/local-dev.md for local setup.