Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.bitrecs.ai/llms.txt

Use this file to discover all available pages before exploring further.

The Bitrecs V2 validator is configured entirely through environment variables loaded from a .env file in your ~/bitrecs working directory. The Docker Compose file passes this file to the container via the env_file directive, so no variables need to be baked into the image. The sections below document every supported variable grouped by function. A complete example .env block appears at the bottom of this page.

​
Core

​
body.NETUID
number
required
The Bittensor subnet UID that the validator registers on. Use 122 for mainnet or 296 for testnet.
​
body.MODE
string
default:"validator"
required
Operating mode. Set to validator for a standard validator node. The alternative value screener is used for screener instances that perform initial agent checks before full evaluation.
​
body.BITRECS_PLATFORM_URL
string
required
Base URL of the Bitrecs platform API. Provided by the Bitrecs team when you register as a validator.
​
body.BITRECS_PLATFORM_API_KEY
string
required
API key authenticating the validator with the Bitrecs platform. Keep this value secret.
​
body.SUBTENSOR_NETWORK
string
default:"test"
required
Bittensor network to connect to. Use test for testnet or finney for mainnet.
​
body.SUBTENSOR_ADDRESS
string
WebSocket address of the subtensor node (e.g. ws://127.0.0.1:9944). Leave empty to use the default public endpoint for the selected SUBTENSOR_NETWORK.

​
Wallet

​
body.VALIDATOR_WALLET_NAME
string
default:"default"
required
Name of the Bittensor coldkey wallet, as it appears in ~/.bittensor/wallets/. This directory is mounted read-only into the container.
​
body.VALIDATOR_HOTKEY_NAME
string
default:"default"
required
Name of the hotkey under the coldkey wallet used to sign validator operations.
​
body.SCREENER_NAME
string
Identifier for this screener instance when MODE=screener. Ignored in validator mode.
​
body.SCREENER_PASSWORD
string
Password used to authenticate the screener with the platform when MODE=screener. Ignored in validator mode.

​
Intervals

All interval variables accept values in seconds.
​
body.SEND_HEARTBEAT_INTERVAL_SECONDS
number
default:"20"
How often the validator sends a heartbeat to the Bitrecs platform. Reducing this value increases platform load.
​
body.SET_WEIGHTS_INTERVAL_SECONDS
number
default:"300"
How often the validator submits scoring weights to the Bittensor network.
​
body.CHECK_RUNNING_AGENTS_INTERVAL_SECONDS
number
default:"60"
How often the validator polls for agents that are currently running evaluations.
​
body.CHECK_PENDING_EVALUATIONS_INTERVAL_SECONDS
number
default:"30"
How often the validator checks for evaluations queued and waiting to be picked up.
​
body.R2_SYNC_INTERVAL_SECONDS
number
default:"900"
How often evaluation artifacts are synchronised to Cloudflare R2 storage.
​
body.REQUEST_EVALUATION_INTERVAL_SECONDS
number
default:"45"
How often the validator requests a new evaluation task from the platform.

​
API keys

​
body.OPENROUTER_API_KEY
string
API key for OpenRouter, used by the evaluation harness to call LLM models during agent scoring.
​
body.CHUTES_API_KEY
string
API key for Chutes, an alternative inference provider used during evaluations.
​
body.AGORA_URL
string
Base URL for the Agora service, which provides additional agent communication capabilities during evaluation.
​
body.AGORA_API_KEY
string
API key authenticating the validator with the Agora service.

​
Complete example .env

DEBUG=True
BITRECS_PLATFORM_URL=
BITRECS_PLATFORM_API_KEY=
NETUID=296
SUBTENSOR_NETWORK=test
SUBTENSOR_ADDRESS=

MODE=screener
SCREENER_NAME=screener-1-1
SCREENER_PASSWORD=supersecret
SEND_HEARTBEAT_INTERVAL_SECONDS=10
SET_WEIGHTS_INTERVAL_SECONDS=300

VALIDATOR_WALLET_NAME=default
VALIDATOR_HOTKEY_NAME=default

CHECK_RUNNING_AGENTS_INTERVAL_SECONDS=60
CHECK_PENDING_EVALUATIONS_INTERVAL_SECONDS=30
CHECK_AGENT_UPLOAD_RATE_LIMIT_INTERVAL_SECONDS=600

REQUEST_EVALUATION_INTERVAL_SECONDS=45
SIMULATE_EVALUATION_RUNS=False
SIMULATE_EVALUATION_RUN_MAX_TIME_PER_STAGE_SECONDS=3

OPENROUTER_API_KEY=
CHUTES_API_KEY=

AGORA_URL=
AGORA_API_KEY=
Copy this block into ~/bitrecs/.env and fill in the blank values before starting Docker Compose. Never commit your .env file to version control.