terminus-lab 0.1.0__tar.gz

terminus_lab-0.1.0/LICENSE

@@ -0,0 +1,27 @@
+MIT License
+
+Copyright (c) 2026 Khaled
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+Terminus is a research tool. It does not constitute financial advice. Past
+performance in backtests does not guarantee future results. Trade at your
+own risk. No warranty that strategies surviving Terminus will be profitable
+in live markets. The authors are not responsible for trading losses, missed
+opportunities, or decisions made using this software.

terminus_lab-0.1.0/PKG-INFO

@@ -0,0 +1,167 @@
+Metadata-Version: 2.4
+Name: terminus-lab
+Version: 0.1.0
+Summary: End of All Trades — ruthless backtesting lab for long-only spot strategies.
+Author: Stronex Labs
+License: MIT
+Project-URL: Homepage, https://github.com/Stronex-Labs/terminus
+Project-URL: Documentation, https://github.com/Stronex-Labs/terminus/tree/main/docs
+Project-URL: Issues, https://github.com/Stronex-Labs/terminus/issues
+Keywords: backtest,crypto,trading,walk-forward,spot,halal,shariah,quantitative,strategy
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Financial and Insurance Industry
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Office/Business :: Financial :: Investment
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.24
+Requires-Dist: pandas>=2.0
+Requires-Dist: pandas-ta>=0.3.14b
+Requires-Dist: pyarrow>=10.0
+Requires-Dist: httpx>=0.25
+Requires-Dist: python-dotenv>=1.0
+Provides-Extra: ml
+Requires-Dist: xgboost>=2.0; extra == "ml"
+Requires-Dist: scikit-learn>=1.3; extra == "ml"
+Requires-Dist: httpx>=0.25; extra == "ml"
+Provides-Extra: dev
+Requires-Dist: pytest>=7; extra == "dev"
+Requires-Dist: pytest-asyncio>=0.21; extra == "dev"
+Requires-Dist: ruff>=0.1; extra == "dev"
+Dynamic: license-file
+
+<p align="center">
+  <img src="assets/logo.png" alt="Terminus" width="320"/>
+</p>
+
+<h1 align="center">Terminus</h1>
+<p align="center"><em>End of All Trades</em></p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square" />
+  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" />
+  <img src="https://img.shields.io/badge/status-alpha-orange?style=flat-square" />
+  <img src="https://img.shields.io/badge/halal--first-spot%20only-gold?style=flat-square" />
+  <img src="https://img.shields.io/github/stars/Stronex-Labs/terminus?style=flat-square" />
+</p>
+
+<p align="center"><strong>Where strategies go to prove themselves — or die.</strong></p>
+
+---
+
+Terminus is a pure Python backtesting engine built for one thing: **honest results**.
+
+8 years of market data. Year-by-year walk-forward with frozen parameters. Realistic fees and slippage. A content-hashed simulation store so you never burn compute twice.
+
+Most backtesting tools let you cheat. Terminus doesn't.
+
+---
+
+## Why Terminus
+
+- **Near-perfect walk-forward required** — frozen parameters tested year by year. At most 2 losing years tolerated, each no worse than −10%.
+- **Bear years count** — 2022 was −64% on BTC. Your strategy survives that or it doesn't ship.
+- **Multi-pair generalization required** — works on one pair? That's a curve fit. Terminus requires success across multiple pairs.
+- **Realistic execution** — fees, entry slippage, stop slippage, TP slippage, timeout slippage, cooldowns, max-hold. Tiered by market cap.
+- **Halal-first** — spot-only, no leverage, no shorts, no interest. Cash (stablecoin) is a valid position in bear regimes.
+- **Content-hashed cache** — every sim keyed by `hash(pair + tf + config + date_range + slippage + fee)`. Same inputs = instant cache hit.
+
+---
+
+## Quickstart
+
+```bash
+pip install terminus-lab
+
+# Fetch 8 years of data
+terminus fetch --pairs BTCUSDT,ETHUSDT,SOLUSDT --tfs 1h,4h,1d --days 2920
+
+# Run the full sweep
+terminus sweep
+
+# Walk-forward the top candidates year-by-year
+terminus walk-forward --top 15
+
+# Generate the report
+terminus report --min-calmar 1.5 --min-bear-return -5
+```
+
+---
+
+## Example Output
+
+```
+=== TOP 15 SURVIVORS by ANNUALIZED return ===
+ Rank  Pair       TF    Family                   Yrs   TotalRet   AnnRet   Calmar   Bear22
+ ----- ---------- ----  -----------------------  ----  --------   ------   ------   ------
+   1   TIAUSDT    2h    Ichi-bull+BTCreg          3/3    +90.7%    +24.0%    2.77     -
+   2   XRPUSDT    2h    Ichi-bull+BTCreg          6/6   +213.5%    +21.0%    5.68    +0.0%
+   3   LTCUSDT    12h   Ichi-bull+BTCreg          3/3    +70.1%    +19.4%    4.28    +0.0%
+   4   BNBUSDT    1h    ROC10+BTCreg              5/5   +133.2%    +18.4%    4.93    +0.0%
+   5   SOLUSDT    4h    ATR-brk                   5/5   +130.6%    +18.2%    7.86   +13.2%
+```
+
+---
+
+## What's Inside
+
+| Module | What it does |
+|--------|-------------|
+| **Sweep engine** | Runs thousands of configs in parallel, skips cache hits |
+| **Walk-forward** | Frozen / anchored / rolling — calendar-year folds |
+| **Portfolio builder** | Correlation-capped leg selection, blended Sharpe/Calmar |
+| **ML module** | XGBoost regime classifier (BULL/BEAR/CHOP) + WF-aware optimizer |
+| **Community hub** | Contribute sim results, query the global leaderboard |
+| **SQLite store** | Local 6-table schema, travels with your research |
+
+**30+ strategy families** — RSI, EMA/MACD crosses, Bollinger, Donchian, ATR breakouts, Ichimoku, Supertrend, Keltner, VWAP reclaim, Heikin Ashi, ROC momentum, and more.
+
+---
+
+## Philosophy
+
+Terminus is **pessimistic by default**. It will tell you your strategy doesn't work before it tells you it does. That's the point.
+
+Terminus is **reproducible by design**. The content-hash cache means any claim in a report traces back to the exact inputs that produced it. `sims.db` travels with your conclusions.
+
+Terminus is **spot-only, halal-first**. Built by someone who can't use futures or margin. If you have those tools, you have more alpha. If you don't — Terminus fits your constraints natively.
+
+---
+
+## Community Hub
+
+```
+https://terminus-hub.shatla-tech.workers.dev/api/v1
+```
+
+Contribute your sim results. Query the global leaderboard. Every user's runs feed the aggregate — rare pairs and exotic timeframes covered by people who care about them.
+
+---
+
+## Status
+
+**Alpha.** Used in production on a paper-trading bot running 7 pairs. API may shift. Results format and research data model are stable.
+
+---
+
+## Contributing
+
+PRs welcome for:
+- New strategy families (numpy-vectorized signals)
+- Alternative data fetchers (Kraken, Coinbase, OKX, Bybit spot)
+- Portfolio construction methods
+- New walk-forward modes
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## License
+
+MIT. Use it, fork it, ship it. If you find something useful, open a PR — the community sim database grows stronger with every contributor.

terminus_lab-0.1.0/README.md

@@ -0,0 +1,129 @@
+<p align="center">
+  <img src="assets/logo.png" alt="Terminus" width="320"/>
+</p>
+
+<h1 align="center">Terminus</h1>
+<p align="center"><em>End of All Trades</em></p>
+
+<p align="center">
+  <img src="https://img.shields.io/badge/python-3.10%2B-blue?style=flat-square" />
+  <img src="https://img.shields.io/badge/license-MIT-green?style=flat-square" />
+  <img src="https://img.shields.io/badge/status-alpha-orange?style=flat-square" />
+  <img src="https://img.shields.io/badge/halal--first-spot%20only-gold?style=flat-square" />
+  <img src="https://img.shields.io/github/stars/Stronex-Labs/terminus?style=flat-square" />
+</p>
+
+<p align="center"><strong>Where strategies go to prove themselves — or die.</strong></p>
+
+---
+
+Terminus is a pure Python backtesting engine built for one thing: **honest results**.
+
+8 years of market data. Year-by-year walk-forward with frozen parameters. Realistic fees and slippage. A content-hashed simulation store so you never burn compute twice.
+
+Most backtesting tools let you cheat. Terminus doesn't.
+
+---
+
+## Why Terminus
+
+- **Near-perfect walk-forward required** — frozen parameters tested year by year. At most 2 losing years tolerated, each no worse than −10%.
+- **Bear years count** — 2022 was −64% on BTC. Your strategy survives that or it doesn't ship.
+- **Multi-pair generalization required** — works on one pair? That's a curve fit. Terminus requires success across multiple pairs.
+- **Realistic execution** — fees, entry slippage, stop slippage, TP slippage, timeout slippage, cooldowns, max-hold. Tiered by market cap.
+- **Halal-first** — spot-only, no leverage, no shorts, no interest. Cash (stablecoin) is a valid position in bear regimes.
+- **Content-hashed cache** — every sim keyed by `hash(pair + tf + config + date_range + slippage + fee)`. Same inputs = instant cache hit.
+
+---
+
+## Quickstart
+
+```bash
+pip install terminus-lab
+
+# Fetch 8 years of data
+terminus fetch --pairs BTCUSDT,ETHUSDT,SOLUSDT --tfs 1h,4h,1d --days 2920
+
+# Run the full sweep
+terminus sweep
+
+# Walk-forward the top candidates year-by-year
+terminus walk-forward --top 15
+
+# Generate the report
+terminus report --min-calmar 1.5 --min-bear-return -5
+```
+
+---
+
+## Example Output
+
+```
+=== TOP 15 SURVIVORS by ANNUALIZED return ===
+ Rank  Pair       TF    Family                   Yrs   TotalRet   AnnRet   Calmar   Bear22
+ ----- ---------- ----  -----------------------  ----  --------   ------   ------   ------
+   1   TIAUSDT    2h    Ichi-bull+BTCreg          3/3    +90.7%    +24.0%    2.77     -
+   2   XRPUSDT    2h    Ichi-bull+BTCreg          6/6   +213.5%    +21.0%    5.68    +0.0%
+   3   LTCUSDT    12h   Ichi-bull+BTCreg          3/3    +70.1%    +19.4%    4.28    +0.0%
+   4   BNBUSDT    1h    ROC10+BTCreg              5/5   +133.2%    +18.4%    4.93    +0.0%
+   5   SOLUSDT    4h    ATR-brk                   5/5   +130.6%    +18.2%    7.86   +13.2%
+```
+
+---
+
+## What's Inside
+
+| Module | What it does |
+|--------|-------------|
+| **Sweep engine** | Runs thousands of configs in parallel, skips cache hits |
+| **Walk-forward** | Frozen / anchored / rolling — calendar-year folds |
+| **Portfolio builder** | Correlation-capped leg selection, blended Sharpe/Calmar |
+| **ML module** | XGBoost regime classifier (BULL/BEAR/CHOP) + WF-aware optimizer |
+| **Community hub** | Contribute sim results, query the global leaderboard |
+| **SQLite store** | Local 6-table schema, travels with your research |
+
+**30+ strategy families** — RSI, EMA/MACD crosses, Bollinger, Donchian, ATR breakouts, Ichimoku, Supertrend, Keltner, VWAP reclaim, Heikin Ashi, ROC momentum, and more.
+
+---
+
+## Philosophy
+
+Terminus is **pessimistic by default**. It will tell you your strategy doesn't work before it tells you it does. That's the point.
+
+Terminus is **reproducible by design**. The content-hash cache means any claim in a report traces back to the exact inputs that produced it. `sims.db` travels with your conclusions.
+
+Terminus is **spot-only, halal-first**. Built by someone who can't use futures or margin. If you have those tools, you have more alpha. If you don't — Terminus fits your constraints natively.
+
+---
+
+## Community Hub
+
+```
+https://terminus-hub.shatla-tech.workers.dev/api/v1
+```
+
+Contribute your sim results. Query the global leaderboard. Every user's runs feed the aggregate — rare pairs and exotic timeframes covered by people who care about them.
+
+---
+
+## Status
+
+**Alpha.** Used in production on a paper-trading bot running 7 pairs. API may shift. Results format and research data model are stable.
+
+---
+
+## Contributing
+
+PRs welcome for:
+- New strategy families (numpy-vectorized signals)
+- Alternative data fetchers (Kraken, Coinbase, OKX, Bybit spot)
+- Portfolio construction methods
+- New walk-forward modes
+
+See [CONTRIBUTING.md](CONTRIBUTING.md).
+
+---
+
+## License
+
+MIT. Use it, fork it, ship it. If you find something useful, open a PR — the community sim database grows stronger with every contributor.

terminus_lab-0.1.0/pyproject.toml

@@ -0,0 +1,53 @@
+[build-system]
+requires = ["setuptools>=68", "wheel"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "terminus-lab"
+version = "0.1.0"
+description = "End of All Trades — ruthless backtesting lab for long-only spot strategies."
+readme = "README.md"
+license = { text = "MIT" }
+authors = [
+    { name = "Stronex Labs" },
+]
+requires-python = ">=3.10"
+keywords = [
+    "backtest", "crypto", "trading", "walk-forward", "spot",
+    "halal", "shariah", "quantitative", "strategy",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Financial and Insurance Industry",
+    "License :: OSI Approved :: MIT License",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Office/Business :: Financial :: Investment",
+]
+dependencies = [
+    "numpy>=1.24",
+    "pandas>=2.0",
+    "pandas-ta>=0.3.14b",
+    "pyarrow>=10.0",
+    "httpx>=0.25",
+    "python-dotenv>=1.0",
+]
+
+[project.optional-dependencies]
+ml = ["xgboost>=2.0", "scikit-learn>=1.3", "httpx>=0.25"]
+dev = ["pytest>=7", "pytest-asyncio>=0.21", "ruff>=0.1"]
+
+[project.scripts]
+terminus = "terminus.cli:main"
+
+[project.urls]
+Homepage = "https://github.com/Stronex-Labs/terminus"
+Documentation = "https://github.com/Stronex-Labs/terminus/tree/main/docs"
+Issues = "https://github.com/Stronex-Labs/terminus/issues"
+
+[tool.setuptools.packages.find]
+include = ["terminus*"]
+exclude = ["tests*", "docs*", "examples*"]

terminus_lab-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

terminus_lab-0.1.0/terminus/__init__.py

@@ -0,0 +1,44 @@
+"""Terminus — ruthless backtesting lab for long-only spot strategies.
+
+Public API:
+    from terminus import (
+        ResearchStore, simulate, VRule,
+        build_all_configs, run_full_sweep,
+        walk_forward_frozen, filter_sims,
+        greedy_portfolio,
+    )
+
+ML (requires pip install terminus-lab[ml]):
+    from terminus.ml import RegimeClassifier, optimize_params
+"""
+from __future__ import annotations
+
+__version__ = "0.1.0"
+
+from .store import ResearchStore, SimRecord, get_store, hash_config
+from .simulate import simulate_fast as simulate
+from .rules import VRule
+from .indicators import precompute_all, precompute_v2, build_btc_regime_series
+from .registry import (
+    build_v1_configs, build_v2_configs, build_all_configs,
+    build_configs_with_regime, all_exit_methods, count_configs,
+)
+from .walk_forward import walk_forward_frozen, walk_forward_reopt_anchored
+from .filter import filter_sims, Survivor, survivor_report
+from .portfolio import greedy_portfolio, reconstruct_legs, correlation
+from .sweep import run_full_sweep
+from . import telemetry
+
+__all__ = [
+    "__version__",
+    "ResearchStore", "SimRecord", "get_store", "hash_config",
+    "simulate", "VRule",
+    "precompute_all", "precompute_v2", "build_btc_regime_series",
+    "build_v1_configs", "build_v2_configs", "build_all_configs",
+    "build_configs_with_regime", "all_exit_methods", "count_configs",
+    "walk_forward_frozen", "walk_forward_reopt_anchored",
+    "filter_sims", "Survivor", "survivor_report",
+    "greedy_portfolio", "reconstruct_legs", "correlation",
+    "run_full_sweep",
+    "telemetry",
+]