rl-swarm on ( Ubuntu WSL )

A guide simple installation and running Gensyn rl-swarm on Ubuntu WSL / Local deviece

💻 System Requirements

Requirement
Details

CPU Architecture

amd64

Recommended RAM

24 GB

Recommended GPU

RTX 3090, RTX 4090, RTX 5090, or GPU with > 12 GB VRAM

Python Version

Python >= 3.10 (For Mac, you may need to upgrade)

Cuda Version

12.8+

Note: You can running rl-swarm with minimum 8gb VRAM, if you have at least 32 gb RAM on your device.

📥 Installation

  1. for the ubuntu culture XD

sudo apt update && sudo apt upgrade -y

  1. Install other dependencies

sudo apt update && sudo apt install -y python3 python3-venv python3-pip curl wget screen git lsof nano unzip iproute2

  1. Install node.js and npm

curl -fsSL https://raw.githubusercontent.com/prolinkmoon/gensyn-testnet/main/install-nodejs.sh -o install-nodejs.sh && chmod +x install-nodejs.sh && ./install-nodejs.sh

  1. Install cuda-toolkit

curl -o install-cuda.sh https://raw.githubusercontent.com/prolinkmoon/gensyn-testnet/main/install-cuda.sh && chmod +x install-cuda.sh && ./install-cuda.sh

  1. Clone the gensyn repo and navigate to it:

git clone https://github.com/gensyn-ai/rl-swarm.git && cd rl-swarm

  1. Start the Swarm:

python3 -m venv .venv
source .venv/bin/activate
./run_rl_swarm.sh

  1. Login

Open http://localhost:3000 on your browser and login with your email.

>> Would you like to push models you train in the RL swarm to the Hugging Face Hub? [y/N] optional: type N + enter

>> Enter the name of the model you want to use in huggingface repo/name format, or press [Enter] to use the default model. use default: enter

>> Would you like your model to participate in the AI Prediction Market? [Y/n] Recommended: type Y + enter

"The Swarm" Discord Role by running Gensyn Monitoring

This guide will walk you through setting up a Gswarm Telegram Bot to monitor your swarm node and earn The Swarm Discord role.

📘 Official Docs: Gswarm.dev/docs

🚀 Step 1: Install Go and Gswarm

First, make sure you have Go installed properly. If you're unsure, just run these commands:

# Remove existing Go (if any)
sudo rm -rf /usr/local/go

# Install Go 1.22.4
curl -L https://go.dev/dl/go1.22.4.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local

# Set Go environment variables
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> ~/.bash_profile
echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.bash_profile
source ~/.bash_profile

# Check version
go version

Now install the Gswarm CLI:

go install github.com/Deep-Commit/gswarm/cmd/gswarm@latest

You should now be able to run gswarm from anywhere in your terminal.

✅ Verify Installation:

gswarm --version

🤖 Step 2: Create Your Telegram Bot

1. Generate a Bot with @BotFather

  • Open Telegram and search for @BotFather

  • Send /newbot and follow the steps (pick a name and username)

  • Save the Bot Token you receive

2. Find Your Chat ID

  • Start a conversation with your bot and send any message

  • Visit the following URL in your browser (replace with your actual bot token):

https://api.telegram.org/bot<YOUR_BOT_TOKEN>/getUpdates

  • Enable Pretty Print to make the JSON readable

  • Look for the "chat": {"id": ...} field in the response — that number is your chat ID

📌 Note: If the result is empty ("result": []), send a message to your bot and refresh the page.

🔧 Step 3: Run the Gswarm Bot

Back in your terminal, simply run:

gswarm

Follow the interactive prompts to enter:

  • Your Telegram Bot Token

  • Your Chat ID

  • Your EOA Address (visible in your Gensyn Dashboard)

🌐 Step 4: Link Discord & Telegram

To receive The Swarm Discord role:

1. Get the Code

On Discord, go to the #|swarm-link channel Type:

/link-telegram

2. Verify in Telegram

Open your Telegram bot Type:

/verify <code>

(Replace <code> with the one you got on Discord) Once verified, your accounts will be linked — and you'll get the shiny new The Swarm role!

PreviousGensyn

Last updated