tam
Config-driven event backtesting for stocks/indices: YAML in, an interactive
HTML dashboard out. Strategies (moving-average, MA crossover, trend rotation,
online-learning ML, local-LLM) are all pluggable — examples/backtest.py
doesn't import any strategy directly, it builds whatever's listed in the
config's strategies: section by name.
Published on PyPI as tam-quant (pip install tam-quant; import tam either
way). Running in Google Colab or Jupyter instead of this repo's own CLI? See
NOTEBOOK.md. Want to use individual pieces (data fetching,
rendering, live updates) outside the config-driven runner, or see every
component's API at a glance? See LIB.md.
Setup
Requires uv and Python 3.11 (pinned in
.python-version — uv will fetch it automatically if you don't have it).
uv sync --extra dev
This creates .venv/ and installs everything, including dev dependencies
(pytest). Run any command below with uv run ... so it uses that environment
— no need to activate the venv manually.
If you want to use the FMP data provider instead of the (no-key-needed)
yfinance default, copy .env.example to .env and fill in FMP_API_KEY.
Running the examples
Each example is a YAML config passed to the same runner:
uv run python -m examples.backtest examples/moving_average_config.yaml
uv run python -m examples.backtest examples/ma_crossover_config.yaml
uv run python -m examples.backtest examples/trend_rotation_config.yaml
These three work out of the box — no extra setup, no external services. Each
run prints a summary table (returns, Sharpe, drawdown, etc. per strategy)
with a live progress bar, and writes an interactive HTML dashboard to
examples/output/<name>_report.html — open that in a browser to see the
equity curves, drawdown, and per-trade markers (toggle with the "Show
Trades" button).
examples/llm_trading_config.yaml is different: it drives a strategy that
queries a local language model each simulated day, and by default also
periodically LoRA fine-tunes it (both via mlx-lm, Apple Silicon only). The
first run downloads the base model from Hugging Face (needs network once).
Because it calls the model every simulated day, this one is much slower than
the others — try a short date range first (edit start/end in the config)
before running the full period. See the comments in that file for how to
point it at Ollama or another server instead, or turn LoRA fine-tuning off.
Want to try your own mix of strategies? Copy one of the configs and edit its
strategies: list — see tam/strategy/*.py for what's registered and what
params each one takes.
Running the tests
uv run pytest
No network access or external services required — everything is tested against fakes/mocks (fake data providers, a stubbed LLM client, etc.).
1 maintainer
Metadata
1 maintainer
Release files for tam-quant 0.1.12
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| tam_quant-0.1.12.tar.gz | 143.9 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| tam_quant-0.1.12-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 257.9 kB
Release files / tam_quant-0.1.12.tar.gz
| Download URL | tam_quant-0.1.12.tar.gz |
|---|---|
| Size | 143.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
44812c4db4d005b71fec9b1732de2ea0072cc9455aeeadfefc6aa8baf3c9c12c
|
|
BLAKE2b-256 checksum How to use checksums |
facecc6b6b119e34734f7ff8730ce494866962af69563f1b67cc42ff811c88f4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / tam_quant-0.1.12-py3-none-any.whl
| Download URL | tam_quant-0.1.12-py3-none-any.whl |
|---|---|
| Size | 114.0 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7086b37f39eaba9b1f633b6399058dab6b92face96453f16f1285d65366ddbca
|
|
BLAKE2b-256 checksum How to use checksums |
42b72a224c59294bd8e5a4e4277bd5d6799047528ced4477a803a31462de6e3a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.2 {"installer":{"name":"uv","version":"0.12.2","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
