💻 Gensyn-ai-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: 1️⃣ How to Login or access http://localhost:3000/ in VPS? 📶

• 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: 5️⃣ Choose customised model's

Here we go🚀

Its Done ✅

It will Generate Logs Soon🙌

Detach & Attach from screen

ctrl A D To Detach from screen

• Attach with previous screen:

screen -r gensyn

🛠 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:

---

🐝SWARM Role & TG bot Set-Up

1. Install Go

Linux/Wsl

cd ~
wget https://go.dev/dl/go1.24.0.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.24.0.linux-amd64.tar.gz

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc
source ~/.bashrc

• Verify installation

go version

Mac

brew install go

2. Telegram Bot Set-Up 🤖

To receive notifications via Telegram, you need to set up a Telegram bot and connect it to your account:

2.1 Create a Telegram Bot:

• Go To https://t.me/BotFather

• Send /newbot and follow the instructions:

• It will Ask You to enter the Name & username of the Bot:

• Now it will send the Token. Look Like this: 84100000:AAGITsRXgxxxxNuP56-xxxxxxxxxxxxxxx dont share with anyone:

2.2 Get Your Chat ID:

• head to your bot which was created and send message:

• Visit: https://api.telegram.org/botYOUR_BOT_TOKEN/getUpdates

• Dont Forget to replace YOUR_BOT_TOKEN with your: which we create in above step:

• You will see your Id here : Save it:

• Note: If you get an empty result {"ok":true,"result":[]}, you may need to send a message to your bot first, then refresh the URL.

3. Installation & Configure GSwarm

1. Installation

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

• Verify installation:

gswarm --version

2. Configure GSwarm:

• We will config our Gensyn Node and telegram bot here: Will Add bot token, chat ID, and EOA address

gswarm

• Enter Your BotToken from : 2.1 Create a Telegram Bot:

• Enter Your ChainId From : 2.2 Get Your Chat ID:

• Enter Your EOA address From: Gensyn Dashboard --Login with your gensyn Mail:

4. 🔗 Linking Discord & Telegram:

1. Get the verification code From Discord

• In Gensyn Dc go to swarm-link channel

• Enter /link-telegram

• You will get your code from here:

2. Verify the code in Telegram Bot

• Go to Your bot which you creat:

• type /verify {code} , Replace code with your actual one: which u got from DC:

• After verify your code You will automatically get your Role:

✔️✔️✔️Done:

---

📈 Upgrade to new release (v0.5.8) {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

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

• If u got terminated then follow: 6️⃣Resolve Terminated Error

👉 Join TG for more Updates: https://telegram.me/cryptogg

If U have any issue then open a issue on this repo or Dm me on TG~

Thank U! 👨🏻‍💻    Happy Coding💗