📖 Integration Manual

$GWH × BittensorStep-by-Step Guide

The complete walkthrough for connecting the Genesis World Health token to the Bittensor network — from installation to mainnet launch.

7
Steps
~2 hours
Total Time
Bittensor
Network
$GWH
Token
$GWH × Bittensor Integration Roadmap — 7-step visual guide from prerequisites through mainnet launch

$GWH × Bittensor Integration Roadmap

Detailed Steps

1
🛠️

Install Prerequisites

Set up your development environment

Beginner15–30 min

Before connecting to Bittensor you need Python 3.8+, the Bittensor SDK, and a working knowledge of command-line tools. This step installs everything you need.

aInstall Python 3.8+

Bittensor requires Python 3.8 or higher. Check your version and install if needed.

python3 --version
# If < 3.8, install via your package manager:
# macOS: brew install [email protected]
# Ubuntu: sudo apt install python3.11 python3.11-venv

bCreate a virtual environment

Isolate your GWH subnet dependencies from your system Python.

python3 -m venv gwh-subnet-env
source gwh-subnet-env/bin/activate  # Linux/macOS
# or gwh-subnet-env\Scripts\activate  # Windows

cInstall the Bittensor SDK

The SDK provides btcli (wallet management) and the Python library for building neurons.

pip install bittensor>=8.0.0

dInstall GWH subnet package

Clone the GWH subnet repo and install it in editable mode so you can customize agents.

git clone https://github.com/genesis-world-health/bittensor-subnet.git
cd bittensor-subnet
pip install -e .

💡 Pro Tips

  • Use a dedicated machine or cloud VM (Ubuntu 22.04 recommended) for running neurons 24/7.
  • Ensure you have at least 8 GB RAM and a stable internet connection.
  • Consider using tmux or screen so your processes survive SSH disconnects.

✅ Outcome

You now have Python, Bittensor, and the GWH subnet code installed and ready.

2
🔑

Create a Bittensor Wallet

Generate your coldkey and hotkey

Beginner5–10 min
3
🌐

Register the GWH Subnet

Claim your NetUID on Bittensor

Intermediate10–20 min
4
⚙️

Configure Environment

Set API keys, wallet paths, and subnet parameters

Beginner5–10 min
5
⛏️

Deploy a GWH Miner

Start earning $GWH by serving health recommendations

Intermediate5 min to start, runs 24/7
6
🛡️

Deploy a GWH Validator

Score miners and secure the health AI network

Advanced5 min to start, runs 24/7
7
🚀

Mainnet Launch & Token Economics

Go live with real $GWH distribution

AdvancedWhen ready

🏗️ Architecture Reference

The GWH subnet maps the platform's existing 75+ AI health agent architecture to Bittensor's miner/validator paradigm.

GWH PlatformBittensor Subnet
UserHealthContextHealthQuerySynapse (query fields)
AgentRecommendationOutputHealthQuerySynapse (response fields)
FiveGatesValidationfive_gates_score() in reward.py
BaseAgent.processWithGateValidation()Validator assess_response_gates()
AgentOrchestratorValidator forward() + weight-setting
14 Basic Health AgentsAGENT_MAP in miner.py
Subscription TiersMiner specialization categories

⚖️ Five Gates Scoring Weights

Every miner response is scored across five ethical dimensions. The Do No Harm gate carries the highest weight — responses that fail it are hard-capped at 0.1 reward.

15%
Honor
20%
Integrity
15%
Authenticity
30%
Do No Harm
20%
Truth

Ready to participate in decentralized health AI?