Numinous

Clone the repository

git clone https://github.com/numinouslabs/numinous.git && cd numinous

Install numi CLI tool and dependencies

pip install -e .

Verify installation (should output: numi, version 2.0.0)

numi --version

Create Bittensor wallet coldkey and hotkey

btcli wallet new-coldkey --wallet miner && btcli wallet new-hotkey --wallet miner --wallet-hotkey default

Acquire TAO tokens for registration

# Get testnet TAO from https://taoswap.org/testnet-faucet or mainnet TAO from exchange

Register on testnet (netuid 155). For mainnet: --netuid 6 --network finney

btcli subnet register --netuid 155 --wallet miner --wallet-hotkey default --network test

Configure local gateway with API keys (one-time setup for testing)(optional)

numi gateway configure

Start local gateway for testing(optional)

numi gateway start

Test agent locally with SIGNAL track restrictions(optional)

numi test-agent --agent-file my_agent.py -t SIGNAL

Place agent in expected directory

mkdir -p neurons/miner/agents && cp my_agent.py neurons/miner/agents/

Submit agent to network for SIGNAL track

numi upload-agent --agent-file my_agent.py -t SIGNAL --wallet miner --hotkey default

Link OpenAI API key for GPT-5 access(optional)

numi services link openai

Link OpenRouter API key for multi-model LLM access(optional)

numi services link openrouter

Link Lightning Rod API key for OpenAI-compatible inference(optional)

numi services link lightning-rod

Link Numinous Signals (Eversight) API key for research and news endpoints(optional)

numi services link numinous-signals

Update system packages

sudo apt-get update && sudo apt-get upgrade -y

Install Docker, Docker Compose V2, git, and Python

sudo apt-get install -y docker.io docker-compose-plugin git python3 python3-pip

Start Docker daemon and enable on boot

sudo systemctl start docker && sudo systemctl enable docker

Add user to docker group (avoids needing sudo). Requires logout and login.

sudo usermod -aG docker $USER

Install Bittensor CLI

pip3 install bittensor

Verify installations

docker --version && docker compose version && btcli --version

Clone repository

git clone https://github.com/numinouslabs/numinous.git && cd numinous

Create validator wallet

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

Register validator on testnet. For mainnet: --netuid 6 --network finney

btcli subnet register --netuid 155 --wallet validator --wallet-hotkey default --network test

Create environment file from template

cp .env.validator.example .env.validator

Edit .env.validator - set WALLET_NAME=validator and WALLET_HOTKEY=default

vim .env.validator

Verify wallet files exist at expected location

ls -la ~/.bittensor/wallets/validator/coldkey && ls -la ~/.bittensor/wallets/validator/hotkeys/default

Pull latest validator container image

docker compose -f docker-compose.validator.yaml --env-file .env.validator pull

Start validator in detached mode

docker compose -f docker-compose.validator.yaml --env-file .env.validator up -d

View validator logs (Ctrl+C to exit)(optional)

docker logs -f numinous_validator