Loading
Loading
This information was auto-extracted from the GitHub repository and may be incomplete or out of date. Always refer to the subnet's GitHub repository for the latest instructions.
Requires yt-dlp, ffmpeg, and ffprobe binaries installed on system. Python >=3.10,<3.13. Access to Bittensor wallet files and Cloudflare R2 credentials required.
Docker deployment strongly recommended. Requires yt-dlp, ffmpeg, ffprobe for source authenticity validation. Python >=3.10,<3.13 for local (non-Docker) deployment. Optional OpenAI API key (preferred for semantic/category checks via gpt-4o) or Gemini API key (fallback, uses gemini-3.1-flash-lite-preview).
Create and activate Python virtual environment
cd nexisgen && python -m venv .venv && source .venv/bin/activate
Install nexisgen package with dependencies
pip install -e ".[dev]"
Copy environment template
cp .env.example .env
Configure BT_WALLET_NAME, BT_WALLET_HOTKEY, BT_WALLET_PATH, R2_ACCOUNT_ID, R2_REGION, R2_READ_ACCESS_KEY, R2_READ_SECRET_KEY, R2_WRITE_ACCESS_KEY, R2_WRITE_SECRET_KEY, NEXIS_SOURCES_FILE, and optionally NEXIS_BLOCK_POLL_SEC, NEXIS_DATASET_CATEGORY, TARGET_RESOLUTION, NEXIS_DATASET_SPEC_DEFAULT, NEXIS_MINER_ENABLED_SPECS
# Edit .env with required values
Commit miner read credentials on-chain so validators can discover and access miner bucket
nexis commit-credentials
Start miner continuous loop; builds and uploads one interval package per 50-block interval
nexis mine
Copy Docker validator configuration templates
cd nexisgen/docker && cp validator.env.example validator.env && cp compose.env.example compose.env
Set restrictive permissions on environment files
chmod 600 validator.env compose.env
Configure compose environment variables, particularly wallet host path for Docker mount
# Edit compose.env: set BT_WALLET_HOST_PATH to host wallet directory
Configure required and recommended validator environment variables
# Edit validator.env: set NEXIS_NETUID, BT_NETWORK, BT_WALLET_NAME, BT_WALLET_HOTKEY, BT_WALLET_PATH, R2_ACCOUNT_ID, R2_REGION, NEXIS_BLOCK_POLL_SEC, NEXIS_WORKDIR, NEXIS_RECORD_INFO_BUCKET, NEXIS_RECORD_INFO_ACCOUNT_ID, NEXIS_RECORD_INFO_READ_ACCESS_KEY, NEXIS_RECORD_INFO_READ_SECRET_KEY, and optional OPENAI_API_KEY or GEMINI_API_KEY
Start Docker validator and watchtower services in background
docker compose --env-file compose.env -f docker-compose.validator.yml up -d
Monitor validator logs to verify startup and operation(optional)
docker logs -f nexis-validator