Loading
Loading
Neuron registration trends
Model developers building talking-head systems face a critical challenge: how to benchmark generative models fairly across heterogeneous hardware without centralizing evaluation logic or relying on a single authority to rank performance. Traditional evaluation requires submitting models to a controlled lab environment, introducing delays, vendor lock-in, and opacity in scoring methodology.
A decentralized network of independent validators can solve this by running standardized, reproducible evaluation on each model in parallel. When miners publish their models as immutable Docker images pinned to content hashes, and validators execute the same challenge set (synthetic faces + audio clips) against each submission, performance becomes verifiable and transparent. Validators are economically incentivized to score honestly because their weight-setting decisions are public and subject to audit.
TalkHead implements this on Bittensor by allowing miners to advertise Dockerized talking-head models via image digest on their axons. Validators run an in-process evaluation loop that discovers these submissions, pulls Docker images, executes them against standardized CelebAHQ face and LibriSpeech audio challenges, measures quality and inference latency, and sets on-chain weights based on efficiency-adjusted performance. Results are stored in local SQLite state, making the full scoring pipeline auditable and reproducible.
Use cases were auto-generated from the GitHub repository and may not reflect the latest changes.
TalkHead is a Bittensor subnet where miners advertise Dockerized talking-head models via immutable image digests on their axons, and validators evaluate them locally using standardized challenges (CelebAHQ faces + LibriSpeech audio) to rank performance and set on-chain weights. The validator runs an in-process executor that pulls Docker images, scores them against quality and efficiency metrics, and stores results in SQLite state for weight-setting decisions.
Miners expose a simple axon endpoint serving ImageRef synapse containing their Docker image digest (repo@sha256:...). Validators operate a two-loop system: (1) Submission update loop queries miner axons every ~30 minutes, collects digests, and upserts them into an in-process SQLite executor state; (2) Weight setting loop reads executor-computed metrics from state and sets on-chain weights. The executor runs in a background thread, pulling Docker images from registries, running them in sandboxed containers with file-based IPC (/input, /output), executing standardized challenges, and writing scored results to SQLite.
Challenges are pre-generated from CelebAHQ faces and LibriSpeech audio or loaded from offline directories.
Each evaluation round uses the same challenge set: random CelebAHQ face images paired with LibriSpeech audio clips. Miners are scored on final_score (quality_score with efficiency penalties for latency and peak VRAM). A 4-day resubmission cooldown prevents frequent image_ref changes.
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.
Top 5 submissions by final_score carry forward; new submissions are added. Winner-take-all: highest scorer wins weights (1 - BURN_RATIO); burn allocation goes to the subnet burn address. If all metrics are invalid, 100% weight is set to burn.
The sections above were auto-generated from the GitHub repository and may not reflect the latest changes. View repository
AI-driven Platform Operations Automation
FAQs were auto-generated from the GitHub repository and may not reflect the latest changes.
Holder & total-staked metrics as of 1h ago (hourly snapshot)
Miner only advertises a Docker image digest on its axon; actual model execution happens in validator. No GPU required for miner process itself.
GPU required for running Docker-based model evaluation. Minimum GPU: 12GB VRAM with compute capability 8.6. ffmpeg must be installed and available on PATH for audio/video processing.
Create and activate a Python 3.11+ virtual environment for miner
python -m venv .venv-miner && source .venv-miner/bin/activate
Install miner dependencies from pyproject.toml
pip install -e '.[miner]'
Create local environment file
cp .env.example .env
Configure IMAGE_REF environment variable with published Docker image digest in repo@sha256:... format
# Set IMAGE_REF in .env to your Docker image digest (repo@sha256:...)
Run the miner with Bittensor wallet/hotkey credentials and network selection
python -m neurons.miner --wallet.name <name> --wallet.hotkey <hotkey> --subtensor.network finney
Create and activate a Python 3.11+ virtual environment for validator
python -m venv .venv-validator && source .venv-validator/bin/activate
Install validator dependencies including torch, executor, and scoring packages
pip install -e '.[validator]'
Install NVIDIA Container Toolkit for GPU Docker support and ffmpeg for audio/video processing
sudo apt-get update && sudo apt-get install -y nvidia-container-toolkit ffmpeg
Configure Docker to use NVIDIA Container Toolkit runtime
sudo nvidia-ctk runtime configure --runtime=docker && sudo systemctl restart docker
Create local environment file
cp .env.example .env
Configure STATE_FILE path for SQLite executor state and Hugging Face token for authenticated CelebAHQ/LibriSpeech downloads(optional)
# Set STATE_FILE in .env (default: ./state.db) and optionally HF_TOKEN for dataset access
Set Weights & Biases API key for experiment tracking (optional)(optional)
export WANDB_API_KEY=<your-key>
Run the validator with Bittensor credentials and network selection
python -m neurons.validator --wallet.name <name> --wallet.hotkey <hotkey> --subtensor.network finney