Bitsec.ai

Install dependencies using uv package manager

uv sync

Create .env file and set INFERENCE_API_KEY for LLM inference

cp .env.example .env && export INFERENCE_API_KEY=your_chutes_or_openrouter_key

Register your miner on the Bittensor network

uv run ./bitsec.py miner create [email protected] 'My Miner Name' --wallet my_wallet

Run the agent directly for testing and iteration(optional)

uv run ./bitsec.py miner execute-agent

Run local execution and scoring without Docker Compose(optional)

uv run ./bitsec.py miner run-no-docker

Run the Docker-based local miner flow for production testing(optional)

uv run ./bitsec.py miner run

Submit your agent when ready; reads miner/agent.py

uv run ./bitsec.py miner submit --wallet my_wallet

Install dependencies using uv package manager

uv sync

Create .env file from validator example template

cp .env-validator-example .env

Set CHUTES_API_KEY for scoring and evaluation

export CHUTES_API_KEY=your_chutes_key

Register your validator on the Bittensor network

uv run ./bitsec.py validator create [email protected] 'My Validator' --wallet validator

Start the validator with Docker Compose

docker compose -f docker-compose.validator.yaml up --build -d

Monitor validator logs(optional)

docker logs -f sandbox-validator-1

Stop the validator when done

docker compose -f docker-compose.validator.yaml down