moritztng / cellular

Cellular Automata in PyTorch with Multiplayer Mode in the Browser via WebRTC :video_game:

cellular.mp4

• Full Video on YouTube
• Online Demo

Installation

git clone https://github.com/moritztng/cellular.git
cd cellular
pip3 install -r requirements.txt

Quickstart

Local URL

> python3 cellular.py

success! open http://127.0.0.1:8080/index.html

Public ngrok URL

> python3 cellular.py --public <NGROK_AUTHTOKEN>

success! open https://8a24-2a02-2455-18a7-5000-216-3eff-fe06-1216.ngrok-free.app/index.html

You have to create a free ngrok account and set your personal ngrok authtoken

Complex Example

> python3 cellular.py --port 8080 --public <NGROK_AUTHTOKEN> --device cuda --universe_frequency 30 --universe_size 500  --video_size 500 --video_bitrate 5000000 --logging_debug

Parameters

  -h, --help            show this help message and exit
  --port                set port (default: 8080)
  --public              set authtoken from your personal ngrok account to get a public url. https://dashboard.ngrok.com/get-started/your-authtoken
  --device              set cpu, cuda or auto. (default: auto)
  --universe_frequency  number of universe steps per second (default: 30)
  --universe_size       length of sides of the quadratic universe in pixels (default: 500)
  --video_size          length of sides of the quadratic video stream in pixels (default: 500)
  --video_bitrate       bitrate of the video stream (default: 5000000)
  --logging_debug       set logging level to debug (default: False)

About the Project

The rules of the cellular automata are expressed as PyTorch functions in rules.py and they use 2D convolutions. Therefore, they can be heavily parallized and leverage the GPU. The current state of the automaton is streamed to the React App in the Browser via WebRTC so that the player can interact with it. Multiple players can manipulate the same automaton and everything is synchronized. Feel free to contact me for any questions or feedback and I'm open to collaboration!