Discord • Network • Research

1. Introduction
2. Features
3. Prerequisites
   • Validator Hardware
   • Miner Hardware
4. Installation
5. Running a Validator
6. Running a Miner
   • Restarting your Miner
7. FAQ
8. Contributing
9. License

IMPORTANT: If you are brand new to the Bittensor ecosystem, check out the Bittensor Website before proceeding here!

This repository contains the code for the Cellular Automata Subnet. The primary focus of this subnet is to run, analyze, and store cellular automata to serve as a research and science accelerator. The network itself will serve as a conduit between cellular automata researchers in the scientific community and the computational resources available through the Bittensor community of miners and validators.

The significance of cellular automata lies in their ability to demonstrate how simple rules can evolve into complex patterns and behaviors over time, which can resemble processes observed in nature. This has profound implications in understanding complex systems and emergent behavior because it suggests that complexity may be emergent rather than inherent, arising from the interaction of simple components governed by simple rules, rather than from complexity embedded within the components themselves. Cellular automata have been applied in such diverse fields as, cryptography, physics, and biology, fluid dynamics, and social systems, and art.

As the size or dimensionality of the automaton increases, so does the computational cost, usually exponentially, making extensive exploration and experimentation computationally prohibitive for many teams. Additionally, analyzing the results of CA simulations can be challenging, particularly when dealing with emergent behaviors that are complex, unpredictable, and sometimes difficult to quantify or interpret within the context of real-world phenomena. Bittensor addresses some key challenges in the field, including resource allocation, incentive alignment, and scalability. Its decentralized design enables a peer-to-peer network where nodes are driven to contribute computational results and continually scored by machine learning models to further increase the accuracy, depth and speed of response.

• 1-D Cellular Automata simulated with CellPyLib
• Miner scoring on simulation accuracy and processing time

• 2-D Cellular automata simulated with CellPyLib
• Searchable database of simulation results
• Wolfram Alpha integration

• Requires Python 3.8 or higher.
• Bittensor

- Recommend 16 vCPU + 16 GB memory
- 100 GB balanced persistent disk

Miners are incentivized based on the accuracy of their simulation, and the processing time required to respond to the validator. Here is the minimum, but we recommend you run CA simulations on your server before registering on the mainnet.

- Reommend 16 vCPU + 16 GB memory
- Run the miner using CPU

To install this subnet, first clone and install the dependencies:

# clone repo
git clone https://github.com/vn-automata/bt-automata.git

# change directory
cd bt-automata

# create virtual environment
python3 -m venv venv

# activate the virtual environment
. venv/bin/activate

# disable pip cache
export PIP_NO_CACHE_DIR=1

# install dependencies
pip install -r requirements.txt

# create a local and editable installation
python3 -m pip install -e .

The validator will generate simulation parameters, run the simulation locally, send the parameters to the miner group, and then score the miners based on simulation accuracy and processing time.

# Replace MYWALLET, MYHOTKEY with your wallet details
python neurons/validator.py --netuid XX --wallet.name MYWALLET --wallet.hotkey MYHOTYKEY

We recommend that you run your miner using PM2. PM2 is a production process manager for Node.js applications. It allows you to keep applications alive forever and reload them without downtime.

sudo apt update && sudo apt upgrade -y

sudo apt install npm -y && sudo npm install pm2@latest -g && pm2 update

Register your miner keys to the network

# Replace MYWALLET, MYHOTKEY, and MYPORTNUMBER with your wallet details 
btcli subnet register --netuid XX --wallet.name MYWALLET --wallet.hotkey MYHOTKEY --axon.port MYPORTNUMBER

You can start miner with the following commands, replacing placeholders with your wallet information, subtensor network (assumes you are running a local subtensor ) and port number:

# Replace MYWALLET, MYHOTKEY, and MYPORTNUMBER with your wallet details and port number
pm2 start neurons/miner.py --interpreter python3 -- --netuid XX --subtensor.network local --wallet.name MYWALLET --wallet.hotkey MYHOTKEY --axon.port MYPORTNUMBER

After pulling and updates from the repository, don't forget to restart your miner:

pm2 restart all --update-env

Q: How can I participate in the network? A: You can participate as a miner or a validator. Examples to get started are included in the "Running a Miner" and "Running a Validator" sections.

Q: I am a CA researcher. How can I access the completed simulations? A: Stay tuned. Once we have completed our proof-of-concept phase, we will open up a database of completed simulations from top miners for researchers to access and study.

Q: Can I mine on this subnet with CPU? A: Yes!

For instructions on how to contribute to this subnet, see CONTRIBUTING.md.

This repository is licensed under the MIT License. See the LICENSE file for details.