Last updated: May 1, 2025
-
Go to QuickPod Templates
-
Find
Jupyter Lab CUDA 12.6
, click Clone, and name it (e.g.,Gensyn 12.6
) -
In the Docker settings, add:
-p 3000:3000 --shm-size=16g
Then click Save.
-
Choose a machine:
- CPU: 16GB+ RAM
- GPU: 16GB+ RAM (VRAM can be less or more than 24GB)
Select the template you just created.
-
Click the orange Connect to JupyterLab button.
Inside JupyterLab, click the Terminal icon on the left.
Warning
Skip this if you don’t already have a swarm.pem
file. If you do, drag and drop it into the file panel.
In the terminal, paste and run:
curl -s https://quickpod.github.io/gensyn/init.sh | bash
Wait until installation is complete.
In the terminal, run:
./run.sh
Warning
When prompted to choose between A or B, just press Enter unless you know what to pick. Remember your choice for later.
Just press Enter unless you know about these options.
If you see a screen like this, continue to Steps 6–7.
If not, skip to Step 8.
Click your port 3000 link. It will open a new browser tab.
Note
It may take 1–3 minutes. Just wait until you see this.
-
Enter the token sent to your inbox
If you are not receiving OTP email:
- OTP emails may be mistakenly filtered as spam. Look in your spam or junk folder for the OTP message
- Sometimes, there may be a delay in OTP delivery due to network or server issues. Wait a few minutes before requesting another OTP
- Double-check that the email address entered is correct and free of typos. An incorrect email will prevent delivery of the OTP
-
You should see Login Success
Warning
Note you may need to do step #5
multiple times until you don't get error. of Daemon failed to start in 15.0 seconds
, Gensyn is quite unstable right now. I usually need to try 5 to 10 times on a bad day
If running is succesful you will see these, locate your ORG ID and Peer ID and remember it.
Go to: https://quickpod.github.io/gensyn
Paste your Peer ID, and select A or B (based on Step 5).
Note
Gensyn now uses a new swarm system (A/B). Old swarms are deprecated. New swarms will show 0 wins at start
Example of old swarm (not recommended anymore):
Warning
Save swarm.pem
locally to reconnect later with the same identity.
- Right-click
swarm.pem
- Click Download
Note
Your node will stay running even if you close the browser. To check on it later, just reconnect to JupyterLab.