🧩Gensyn Rl Swarm guide -Mac/Linux

Device/System Requirements

• Open Your Vps

ssh username@ip

Pre-Requirements

Install Python and Other Tools

• For Linux/Wsl

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

• For Mac

brew install python

Check Version

python3 --version

Install Node.js , npm & yarn

• For Linux/Wsl

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt update && sudo apt install -y nodejs

• Install Yarn (linux)

curl -sS https://dl.yarnpkg.com/debian/pubkey.gpg | sudo apt-key add -

echo "deb https://dl.yarnpkg.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/yarn.list > /dev/null

sudo apt update && sudo apt install -y yarn

• For Mac

brew install node && corepack enable && npm install -g yarn

• Check version (Linux/Mac)

node -v

npm -v

yarn -v

Start The Node (Linux/Mac)

1️⃣ Create a screen session (vps only)

screen -S gensyn

2️⃣ Clone RL-SWARM Repo

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

3️⃣ Navigate to rl-swarm

cd rl-swarm

4️⃣ Create & Activate a Virtual Environment

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

5️⃣ Run the swarm Node

./run_rl_swarm.sh

• Now it will promt you to login: Follow: How to Login or access http://localhost:3000/ in VPS -Check FAQ 1️⃣

• Now It will promt Would you like to push models you train in the RL swarm to the Hugging Face Hub? [y/N] Enter N

• Now It will promt >> Enter the name of the model you want to use in huggingface repo/name format, or press [Enter] to use the default model. press Enter & get defalut model:

---❗ If U put model manually then it can be cause of terminated❗--- So better to use Default:

------>>>If u want to select the model then choose between them: Choose customised model's -Check FAQ 5️⃣

Done ✅

It will Generate Logs Soon🙌

Detach & Attach from screen

ctrl A D To Detach from screen

• Attach with previous screen:

screen -r gensyn

---

🧩How To Grab Your Gswarm Role:

You can do this process both in ubuntu or codespace

Step 1. Install Gswarm

# Install Go:
sudo rm -rf /usr/local/go
curl -L https://go.dev/dl/go1.22.4.linux-amd64.tar.gz | sudo tar -xzf - -C /usr/local
echo 'export PATH=$PATH:/usr/local/go/bin:$HOME/go/bin' >> $HOME/.bash_profile
echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> $HOME/.bash_profile
source .bash_profile
go version

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

Verify Installation

gswarm --version

Step 2. Setup Telegram Bot

1. Create a Telegram Bot:

• Chat with @BotFather on Telegram
• Send /newbot and follow the instructions (Choose a name & username)
• Save the bot token id

2. Get Your Chat ID:

• Search your new bot username and send 1-2 messages
• Visit https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates in your browser
• Replace YOUR_BOT_TOKEN with your actual bot token
• Find your chat ID in the response

It looks like this:

{
  "ok": true,
  "result": [
    {
      "message": {
        "message_id": 1893,
        "from": {
          "id": 987654321,
          "is_bot": false,
          "first_name": "GSwarm",
          "username": "gswarm_user",
          "language_code": "en"
        },
        "chat": {
          "id": 987654321,
          "first_name": "GSwarm",
          "username": "gswarm_user",
          "type": "private"
        },
        "date": 2873057400,
        "text": "Hello bot!"
      }
    }
  ]
}

• Extract the Chat ID: chat id 123456789 like this, you will have your own

Step 3. Run Gswarm Bot

Run gswarm in your terminal now and follow the prompts to enter your bot token, chat ID, and EOA address

• You'll find EOA address by logging in the Gensyn Dashboard

Step 4. Linking Discord and Telegram

To link your Discord and Telegram accounts:

1. Get the verification code:

• Go to Discord in #|swarm-link channel
• Type /link-telegram (you will be given a code)

2. Verify the code:

• Go to your Telegram bot
• Type /verify <code> (replace <code> with the code you received)

This will link your Discord and Telegram accounts check your role done

---

FAQ & Troubleshoot

1️⃣ How to Login or access http://localhost:3000/ in VPS? 📶

• Open a new Terminal and login ur vps

• Allow Incoming connection on VPS

sudo apt install ufw -y
sudo ufw allow 22
sudo ufw allow 3000/tcp

• Enable ufw

sudo ufw enable

• Install cloudflared on the VPS

wget -q https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64.deb

sudo dpkg -i cloudflared-linux-amd64.deb

• Check version

cloudflared --version

• Make sure your Node is running on port 3000 in Previous Screen

• Run the tunnel command

cloudflared tunnel --url http://localhost:3000

• Access the Link from your local machine

  

• Now follow Login!

• Done!✅

2️⃣ How to get the Node Name?

• Check the image below to get your Node id!

3️⃣ Save your swarm.pem file (for future login)

• open a wsl window

• If U have to copy this file to your local machine from VPS then Run this command from your local Terminal--

scp USERNAME@YOUR_IP:~/rl-swarm/swarm.pem ~/swarm.pem

It will save here in ur Terminal's Root Directory!

4️⃣ How To start the Next Day (Local Pc)

 cd rl-swarm

 python3 -m venv .venv

source .venv/bin/activate

./run_rl_swarm.sh

5️⃣ Choose customised model's

----> Recommend for Mac

 Gensyn/Qwen2.5-0.5B-Instruct

 Qwen/Qwen3-0.6B

 nvidia/AceInstruct-1.5B

 dnotitia/Smoothie-Qwen3-1.7B

 Gensyn/Qwen2.5-1.5B-Instruct

📋 Model-by-Model Breakdown

6️⃣ Resolve Terminated Error

• Follow these command one by one: (You should be in Rl-swarm directory) ❗

deactivate 
rm -rf .venv

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

./run_rl_swarm.sh

• Now follow all the process from 5️⃣ Run the swarm Node

• If u still Got terminated error then just restart 1-2 times: or just wait few minutes:

📈 Upgrade to new release (v0.5.2) {Mac/Linux}

• Go to gensyn screen (Vps)

screen -r gensyn

• Stop your node by ctrl+c if u are on gensyn screen (Vps)

• Move to rl-swarm directory

cd rl-swarm

• Pull the latest release

git switch main
git reset --hard
git clean -fd
git pull origin main

• Start the swarm Node 🚀

./run_rl_swarm.sh

Made with ❤️ by Morsyxbt