tradingbot

Badges coming soon

Deterministic research and execution scaffold for systematic trading. This repository emphasises testing-first workflows, reproducibility, and a Windows-friendly developer experience.

Quickstart

# clone the repository first, then inside the repo root
py -3.11 -m venv .venv
.\.venv\Scripts\Activate.ps1
python -m pip install --upgrade pip
pip install -r requirements.txt -r requirements-dev.txt
pre-commit install

# bootstrap local services and database schema
scripts\bootstrap.ps1
mvb init-db

# run the daily orchestration (prints proposed tickets JSON)
mvb daily-run

Project Layout

• tradingbot/ core Python package and domain modules
• tradingbot/cli/ Click-based entrypoints (mvb)
• tradingbot/tests/ mirrors package modules with pytest tests
• docker/ container definitions (docker-compose.yml, runtime builds)
• infra/ reserved for infrastructure-as-code assets
• docs/ architecture, workflows, and API notes
• scripts/ automation helpers for local setup

Guiding Principles

• Enforce determinism and reproducibility across pipelines
• Prefer tests-first and automation over manual steps
• Keep developer ergonomics friendly for Windows-first setups
• Log richly, fail loudly, and surface telemetry for learning loops

Next Steps

1. Fill in data adapters, signal generators, and risk engines.
2. Flesh out database models and connect to the persistence layer.
3. Extend CLI commands with concrete orchestration logic and metrics.
4. Document integration points in docs/ as they materialise.