Welcome to Chapaty-Zoo! A library of ready-to-run quantitative trading strategies for the Chapaty backtesting engine. Built from chapaty-template.
Selecting an agent: To choose which strategy runs, change the ACTIVE_AGENT constant in src/main.rs to any variant of the ActiveAgent enum. That single line drives both the backtest and the report output directory.
Windows users: Please read the Windows Users section before proceeding.
# 1. Clone the template (we use 'ct' as a shorthand directory name)
git clone --depth 1 https://github.com/LenWilliamson/chapaty-zoo.git cz
cd cz
# 2. Check dependencies (Rust + Python)
make doctor
# 3. Compile the project and install visualization dependencies
make setup
# 4. Run the shipped demo agent and generate a tearsheet
make run
# 5. Open the resulting HTML report
open chapaty/reports/tearsheet.html # macOS
# xdg-open chapaty/reports/tearsheet.html # Linux| Tool | Installation |
|---|---|
Rust (rustup, cargo) |
rust-lang.org/tools/install (Requires 1.95.0+, Edition 2024) |
Python (3.13.1+) |
pyenv is recommended. |
| LLM Environment | Claude Code, DeepSeek, Gemini CLI, Aider, Cursor, etc. |
The included Makefile is designed for Unix-like systems. To run this project on Windows, you have a few options:
- WSL (Windows Subsystem for Linux): Recommended. Runs the Makefile and paths natively.
- Git Bash: Ships with a
make-compatible shell and covers most commands.
Chapaty uses pre-compiled .postcard environments hosted for free on Hugging Face Datasets. Your first make run automatically downloads and caches the required data locally.
Trading and investing involve substantial risk. You may lose some or all of your capital.
Chapaty is an open-source software project provided for research and educational purposes only. It does not constitute financial, investment, legal, or trading advice.
This software is provided “AS IS”, without warranties or conditions of any kind, express or implied, as stated in the Apache License, Version 2.0. The software may contain bugs, errors, or inaccuracies.
In no event shall the authors or contributors be liable for any direct or indirect losses, damages, or consequences, including but not limited to financial losses, arising from the use of this software.
By using Chapaty, you acknowledge that you are solely responsible for any trading decisions, strategies, or outcomes.