一、项目简介

Gensyn RL Swarm 是一个去中心化的 AI 分布式训练网络，允许用户贡献 GPU 算力来参与模型推理、训练，并获得积分或代币奖励。
它的目标是让每一个拥有 GPU 的人都能加入“AI 计算市场”，成为去中心化的训练节点。

核心组件包括：

• 🐝 Hivemind：负责节点间的 P2P 协作与参数同步。
• 🧩 Reasoning Gym：本地推理训练环境。
• ☁️ Hugging Face Hub：用于权重推送与验证。
• 💰 Gensyn Testnet / Prediction Market：积分与代币结算系统。

二、环境准备

✅ 系统环境

推荐：

• Ubuntu 22.04 LTS（或以上）
• CUDA 12.6+
• Python 3.10 / 3.11
• NVIDIA GPU（建议 RTX 4090 / A100 / V100 级别）

安装依赖

sudo apt update
sudo apt install -y git python3.10 python3.10-venv python3-pip
sudo apt install -y nvidia-driver-570 nvidia-cuda-toolkit

验证：

nvidia-smi
nvcc --version

三、拉取与安装项目

git clone https://github.com/gensyn-ai/rl-swarm.git
cd rl-swarm
python3.10 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install -r requirements.txt

四、首次启动与登录配置

运行启动脚本：

./run_rl_swarm.sh

程序会提示：

Please login to create an Ethereum Server Wallet

✳️ 第一步：使用 Google 登录

打开出现的登录链接（或手动访问）：

http://localhost:3000

用 Google 账号登录，系统会自动在项目目录生成：

runtime/userData.json
swarm.pem

这两个文件非常关键：

• swarm.pem：你的节点私钥（相当于钱包）
• userData.json：Google 登录令牌

⚠️ 请备份 swarm.pem，不要上传或泄露。

五、连接 Hugging Face

当系统提示：

Would you like to push models to Hugging Face? [y/N]

选择 Y 并输入你的 HF Access Token：

Enter your Hugging Face access token: hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

✅ 可以在 https://huggingface.co/settings/tokens 创建。

六、开始参与训练

系统成功启动后，会显示：

🐝 Joining round: 38755
Starting round: 38755/1000000
Map: 100%
pushing model to huggingface

这表示节点正在：

1. 加入当前训练轮；
2. 参与计算 Reasoning Gym 任务；
3. 将本地模型权重推送至 Hugging Face。

GPU 使用情况可用：

watch -n 3 nvidia-smi

七、后台运行方式

若希望节点在后台持续运行，可使用 nohup 或 screen：

cd ~/rl-swarm
source .venv/bin/activate
nohup python -m rgym_exp.runner.swarm_launcher > swarm.log 2>&1 &

或用 tmux：

tmux new -s gensyn
source .venv/bin/activate
python -m rgym_exp.runner.swarm_launcher

退出 tmux 保留运行：Ctrl + B → D