zadescoxp/calibrain-harness

Introduction

Calibrain Harness is a forward-testing harness for crypto perpetual futures on Bybit testnet. It connects a fast classification model to live markets, asks a fixed set of labellable questions on each closed bar, and uses the model's probabilities to make trading decisions only when estimated edge clears defined gates. Every prediction is scored against subsequent price action, allowing model skill to be evaluated independently of trading outcomes.

Quick start

Requirements: Python 3.12, Node.js 20+ with npm, an API key from Kairos (via Minara Cloud) or TypeSafe, and Bybit testnet API keys (create at testnet.bybit.com).

Clone the repository and set up the Python environment:

git clone https://github.com/zadescoxp/calibrain-harness.git
cd calibrain-harness
python3.12 -m venv .venv && .venv/bin/pip install -r requirements.txt
cp .env.example .env   # add your keys

Build the Next.js terminal UI:

cd web-next && npm ci && npm run build && cd ..

Start the service:

.venv/bin/python -m ctb.server

Open http://127.0.0.1:8800. The bot starts in observe-only mode; enable AUTO-TRADE to place orders.

Usage constraints

• Runs on Bybit testnet only; mainnet trading is not supported and the host is hard-coded.
• Requires separate API keys for the decision model and for Bybit testnet (no withdrawal permission).
• Under active development: interfaces and defaults may change between commits.
• U.S. users may face restrictions; see the disclaimer.

HotRepo's take

Calibrain Harness appeared on HotRepo's new-project list for Python on 12 Nov 2026, gaining 4 stars in a 1.5-hour observation window. The repository has 104 stars and 23 forks, but no GitHub daily rank has been recorded. The project is still under development and its README reports early forward-testing results; treat the star count as a measure of initial interest, not validation of trading performance.