cascade

Clone the cascade repository

git clone https://github.com/TensorLink-AI/cascade && cd cascade

Install cascade with hippius (storage/registry) and chain (bittensor) extras. Uses bittensor==10.5.0 exactly.

pip install -e '.[hippius,chain]'

Verify your generator passes all checks: determinism, imports, dependencies, output shape, bounds

cascade verify ./my-generator

Register wallet and hotkey for your submission

btcli wallet new-coldkey --wallet-name my-miner && btcli wallet new-hotkey --wallet-name my-miner --wallet-hotkey gen1

Register the hotkey on subnet netuid 91 (mainnet)

btcli subnets register --netuid 91 --network finney --wallet-name my-miner --wallet-hotkey gen1

Submit your generator privately (recommended) or use 'cascade deploy' + 'cascade fund' for public submission. LIUM_API_KEY environment variable only, never as argument.

export LIUM_API_KEY=sk-... && cascade submit ./my-generator https://submissions.cascadesub.net --wallet-name my-miner --wallet-hotkey gen1 --label my-gen-v1

Monitor your submission in the queue; rounds run every 12 hours at ~08:30 and 20:30 UTC(optional)

cascade queue --intake https://submissions.cascadesub.net --hotkey <your-ss58>

Check round countdown, dethrone bar, and settled verdict with scores(optional)

cascade round && cascade duel

Clone the cascade repository

git clone https://github.com/TensorLink-AI/cascade && cd cascade

Install cascade with hippius (storage/registry) and chain (bittensor) extras. Uses bittensor==10.5.0 exactly.

pip install -e '.[hippius,chain]'

Set environment variables for manifest bucket (S3) and Hippius Hub registry access. Credentials-only, never in files.

export HIPPIUS_S3_ACCESS_KEY=... HIPPIUS_S3_SECRET_KEY=... HIPPIUS_HUB_USERNAME=... HIPPIUS_HUB_PASSWORD=... (or HIPPIUS_HUB_TOKEN=...)

Create validator wallet and hotkey

btcli wallet new-coldkey --wallet-name my-validator && btcli wallet new-hotkey --wallet-name my-validator --wallet-hotkey default

Register on subnet 91 (mainnet). Need stake above threshold for weight-setting.

btcli subnets register --netuid 91 --network finney --wallet-name my-validator --wallet-hotkey default

Smoke test with zero chain/GPU I/O to validate configuration(optional)

cascade-validator --offline --chain-toml chain.toml

Run the validator loop. Keep under a process manager (systemd/tmux). It resumes cleanly from persisted state.

cascade-validator --chain-toml chain.toml --network finney --wallet-name my-validator --wallet-hotkey default

Verify your rounds with offline audit (Tier 0), corpus verification (Tier 1), or full retrain (Tier 2, experimental)(optional)

cascade-audit latest --tier 1 --json