DEV Community

Cover image for Tutorial to run a Gensyn Testnet Node on Quickpod
VikthurrDev
VikthurrDev

Posted on • Edited on

Tutorial to run a Gensyn Testnet Node on Quickpod

#web3 #ai #cloud #gensyn

Here's a step-by-step guide to run a Gensyn RL Swarm Testnet node:

Step 1: Prepare Your Environment

  1. Rent a Cloud GPU
  • QuickPod
    • Sign up at QuickPod
    • Deposit crypto, rent a CUDA 12.4 GPU (e.g., RTX 4090, RTX 3090)
    • Connect via web terminal or SSH

Step 2: Install Dependencies

Run these commands in your terminal (remove sudo when using QuickPod):

Update System 

apt update && apt upgrade -y
Enter fullscreen mode Exit fullscreen mode

Install Basic Tools 

apt install screen curl iptables build-essential git wget lz4 jq make gcc nano automake autoconf tmux htop nvme-cli libgbm1 pkg-config libssl-dev libleveldb-dev tar clang bsdmainutils ncdu unzip libleveldb-dev -y
Enter fullscreen mode Exit fullscreen mode

Install Python 

apt install python3 python3-pip python3-venv python3-dev -y
Enter fullscreen mode Exit fullscreen mode

Install Node.js 

 curl -fsSL https://deb.nodesource.com/setup_22.x | bash -
 apt install -y nodejs
 npm install -g yarn
Enter fullscreen mode Exit fullscreen mode

Install Yarn 

 curl -o- -L https://yarnpkg.com/install.sh | bash
 export PATH="$HOME/.yarn/bin:$HOME/.config/yarn/global/node_modules/.bin:$PATH"
 source ~/.bashrc
Enter fullscreen mode Exit fullscreen mode

Clone the GitHub repository 

git clone https://github.com/gensyn-ai/rl-swarm/
Enter fullscreen mode Exit fullscreen mode

Move into the cloned repository directory 

cd rl-swarm
Enter fullscreen mode Exit fullscreen mode

Open a virtual terminal that runs in the background 

apt install tmux  

tmux new -s gensyn_node
Enter fullscreen mode Exit fullscreen mode

Install swarm 

 python3 -m venv .venv

 . .venv/bin/activate
Enter fullscreen mode Exit fullscreen mode

Start gensyn node 

 ./run_rl_swarm.sh
Enter fullscreen mode Exit fullscreen mode

3. Log in to your node

1. Wait for User Data Creation

  • Action: Monitor your logs until you see: Waiting for userData.json to be created...
  • Note: This confirms the node is ready for login.

2. Access the Login Page

GPU Cloud/VPS Users

  1. Open a new terminal.
  2. Install localtunnel: 
   npm install -g localtunnel
Enter fullscreen mode Exit fullscreen mode
  1. Get your password (VPS IP): 
   curl https://loca.lt/mytunnelpassword
Enter fullscreen mode Exit fullscreen mode
  1. Generate a public URL: 
   lt --port 3000
Enter fullscreen mode Exit fullscreen mode
  1. Access the URL in your browser and enter the password (your VPS IP).

3. Choose your Login

  • Action: Use your preferred login method (e.g., GitHub, email).
  • What Happens Next: After login, the terminal automatically starts the installation process.

4. Complete Setup Prompts

  1. Hugging Face Hub Upload:

    • Prompt: 
     Would you like to push models you train to the Hugging Face Hub? [y/N]

a. - Testnet Users: Press N (no upload).

  1. Select a Model:

    • Prompt: 
     Enter the name of the model (repo/name) or [Enter] for default:

5. Verify Node Operation

  • Action: Check the terminal for a message like: Hello, [your node name] (e.g., "whistling hulking armadillo").
  • Tip: Use CTRL+SHIFT+F to search for "Hello" in logs.

6. Detach from the termux terminal

Press Ctrl + B, then release and press D (Detach).

7. Backup your secret identity

Move into your cloned repository directory, e.g, rl-swarm.

Copy the swarm.pem file into your computer using the SCP protocol.

scp -P {PORT} {USER}@{IP ADDRESS}:{REMOTE PATH TO FILE} {PATH TO WHERE YOU WANT TO SAVE THE FILE IN YOUR COMPUTER}

Create a folder named backup.

e.g scp -P 41200 36****f-***-43c0-a339-038c8***234@74.133. .***.***.248:/***/****/swarm.pem /home/****/backup
Enter fullscreen mode Exit fullscreen mode

Top comments (0)