Verathos

One-command installer (recommended). Alternatively, clone the repo manually.

curl -fsSL https://verathos.ai/install.sh | bash

Manual install: clone repository and run miner setup script which creates venv, installs dependencies, and checks GPU compatibility.(optional)

git clone https://github.com/verathos-ai/verathos.git && cd verathos && bash scripts/setup_miner.sh

Create a new Bittensor wallet for the miner.

btcli wallet create --wallet.name miner

Register on Subnet 96 (requires staking TAO).

btcli subnet register --wallet.name miner --netuid 96 --subtensor.network finney

Show your EVM address and SS58 mirror for funding gas fees.

python scripts/show_evm_info.py --wallet miner --hotkey default

Transfer a small amount of TAO to the EVM mirror address for gas fees.

btcli wallet transfer --dest <SS58_MIRROR> --amount 0.1 --subtensor.network finney

Run the guided interactive wizard to configure wallet, registration, HTTPS, PM2, and config.

verathos setup

Start the miner. HTTPS is required on mainnet. The miner auto-detects GPU, selects the best model, starts vLLM, and registers on-chain.

python -m neurons.miner --wallet miner --hotkey default --model-id auto --netuid 96 --subtensor-network finney --endpoint https://YOUR-PUBLIC-IP

Set up nginx with a self-signed TLS certificate for HTTPS (required on mainnet). Alternatively use Cloudflare Tunnel.

bash scripts/setup_https.sh

Run the miner under PM2 for production reliability (auto-restart, log rotation).(optional)

pm2 start ecosystem.config.js --only miner

One-command validator installer (recommended). Alternatively, clone the repo manually.

curl -fsSL https://verathos.ai/install.sh | bash -s -- --validator

Manual install: clone repository and run validator setup script.(optional)

git clone https://github.com/verathos-ai/verathos.git && cd verathos && bash scripts/setup_validator.sh

Create a new Bittensor wallet for the validator.

btcli wallet create --wallet.name validator

Register on Subnet 96.

btcli subnet register --wallet.name validator --netuid 96 --subtensor.network finney

Fund your EVM address (recommended for on-chain reportOffline votes). Optional but recommended.(optional)

python scripts/show_evm_info.py --wallet validator --hotkey default && btcli wallet transfer --dest <SS58_MIRROR> --amount 0.05 --subtensor.network finney

Set HuggingFace token to avoid rate limits when downloading tokenizers for proof verification.(optional)

export HF_TOKEN="hf_..."

Start the validator. Auto-registers EVM on startup and begins canary testing miners.

python -m neurons.validator --wallet validator --hotkey default --netuid 96 --subtensor-network finney

Run the validator under PM2 for production reliability.(optional)

pm2 start ecosystem.config.js --only validator