Testnet 89: Three gen
This page last updated March 8, 2024
3D generation subnet provides a platform to democratize 3D content creation, ultimately allowing anyone to create virtual worlds, games and AR/VR/XR experiences. This subnet leverages the existing fragmented and diverse landscape of Open Source 3D generative models ranging from Gaussian Splatting, Neural Radiance Fields, 3D Diffusion Models and Point-Cloud approaches to facilitate innovation - ideal for decentralized incentive-based networks via Bittensor. This subnet aims to kickstart the next revolution in gaming around AI native games, ultimately leveraging the broader Bittensor ecosystem to facilitate experiences in which assets, voice and sound are all generated at runtime. This would effectively allow a creative individual without any coding or game-dev experience to simply describe the game they want to create and have it manifested before them in real time.
Hardware Requirements
Pending detailed benchmark results, our recommended setup aligns with Google Cloud's a2-highgpu-1g specs:
- GPU: NVIDIA A100 40GB
- CPU: 12 vCPUs
- RAM: 85GB
- Storage: 200GB SSD
Expectations under continuous operation include about 500GB/month in network traffic and 0.2MB/s throughput.
OS Requirements
Our code is compatible across various operating systems, yet it has undergone most of its testing on Debian 11, Ubuntu 20 and Arch Linux. The most rigorous testing environment used is the Deep Learning VM Image, which includes pre-installed ML frameworks and tools essential for development.
Setup Instructions for Miners and Validators
Environment Preparation
- Virtual Environment: For a clean and isolated setup, use a Python virtual environment. To set up one, execute:
python3 -m venv .venv
source .venv/bin/activate
- Process Management: Utilize PM2 for managing application processes. It offers advantages such as automatic restarts, load balancing, and comprehensive monitoring.
- Dependencies: Install all necessary Python packages:
pip install -r requirements.txt
Miner Configuration
Starting the Miner
To initialize the miner, use:
python neurons/miner.py --netuid 24 --subtensor.network finney --wallet.name YOUR_MINER_COLD_WALLET --wallet.hotkey YOUR_MINER_HOT_WALLET --logging.debug --neuron.device cuda:0
Ensure to replace YOUR_MINER_COLD_WALLET
and YOUR_MINER_HOT_WALLET
with your specific wallet identifiers.
Validator Setup
Additional Dependencies
Before running the validator, ensure to install:
apt-get install libglfw3-dev libgles2-mesa-dev
Launching the Validator
Activate the validator with the following command:
python neurons/validator.py --netuid 24 --subtensor.network finney --wallet.name YOUR_VALIDATOR_COLD_WALLET --wallet.hotkey YOUR_VALIDATOR_HOT_WALLET --logging.debug --neuron.device cuda:0
Similarly, substitute YOUR_VALIDATOR_COLD_WALLET
and YOUR_VALIDATOR_HOT_WALLET
with the actual wallet names. This setup prioritizes GPU utilization for enhanced performance.
Persistent Process Management
For sustained operation of the miner and validator, we advise employing PM2 or an equivalent process manager:
pm2 start --name miner neurons/miner.py -- [OPTIONS]
pm2 start --name validator neurons/validator.py -- [OPTIONS]
Adjust the [OPTIONS] placeholder with respective command-line options as needed.
Updated 5 months ago