🟢 Активные ноды / Active nodes
April 25

Gensyn Node. CPU version. Updated 21.07.2025

Guide updated 21.07.2025

Характеристики: 6CPU / 16GB RAM / 100GB SSD и больше

Арендовать сервер: Hetzner

Операционная сеть: Ubuntu 22.04


Подготовка к установке:

  • Скачиваем и устанавливаем Termius
Для Windows - тут
Для macOS - тут
  • Арендуем север (рекомендую всем начинать свой путь с Hetzner - на нем лучшее соотношение цены и качества, а также зарегистрируясь по рефке вы получите 20€ на свой аккаунт, которые сможете использовать для оплаты серверов. Гайд по аренде сервера на Hetzner.
  • Открываем Termius и жмём New Host
  • Откроется панель для ввода данных, где нам понадобится ввести IP который предоставит нам провайдер после аренды сервера в строке "IP or Hostname"; Любое название, которое вам нравится в "Label"; в строке "Username" вводим root, в строке "Password" вводим выданный пароль:
  • После этого жмем стрелку справа вверху:
  • И наконец-то подключаемся к серверу:

Приступим к установке с нуля:

1. Обновление системы и установка необходимых инструментов разработки:

sudo apt update
sudo apt install -y python3 python3-venv python3-pip curl screen git yarn
sudo npm install -g localtunnel
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
sudo apt update && sudo apt install -y yarn
sudo apt-get update
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
sudo npm install -g yarn
yarn -v

2) Удаляем старую папку, если она есть и клонируем репозиторий:

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

3) Создаем screen сессию с именем gensyn:

screen -S gensyn

4) Создаем, активируем виртуальное окружение и запускаем ноду:

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

5) Запускаем localtunnel

На этом моменте вам нужно:

1) продублировать сессию вашего запущенного сервера. Для этого нажмите правкой кнопкой мыши по открытой вкладке и нажмите Duplicate.

2) В появившемся новом окне вам надо узнать ваш IP (он будет являться вашим паролем), для этого вписываем команду:

curl -s https://api.ipify.org

3) Теперь вставляем команду:

lt --port 3000

4) Вам будет предоставлена ссылка. Вы должны будете перейти на нее с любого устройства.

В Tunnel Password введите IP вашего сервера, который мы узнали и нажмите Click to Submit.

5) Нажмите Login

6) Авторизируйтесь с помощью вашего E-mail (на ваш адрес придет код доступа).

Должно будет появиться такое окно и установка продолжится:

6) Отвечаем на вопрос >> Would you like to push models you train in the RL swarm to the Hugging Face Hub? [y/N] нажатием на клавишу Enter.

7) В процессе нас попросит выбрать модель:

Можете нажать Enter, тогда вам подберут модель автоматически.

Или же укажите модель из списка:

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

Если у вас, как на скрине ниже, то поздравляю - нода запустилась. Но понаблюдайте еще, чтобы убедиться, что не выбило по каким либо причинам.

Поинты можем мониторить на официальном дашборде.

Приступим к установке, если у вас есть ваш swarm.pem:

1. Повторяете пункты из установки с нуля: 1, 2, 3;

2. Копируете ваш swarm.pem в директорию $HOME/rl-swarm;

3. Выполняете остальные пункты из установки с нуля.

Как сделать бекап вашей ноды?

1. Скопируйте файл swarm.pem из директории $HOME/rl-swarm в безопасное место.


Обновление:

1. Переходим в сессию screen

screen -r gensyn

2. Остановите вашу ноду нажатием ctrl+c

3. Выполните команды:

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

4. Запустите ноду заново, повторяя команды из установки с нуля из пунктов: 4, 5, 6, 7


Полезные команды:

Проверка версии вашей ноды

cd $HOME/rl-swarm && git describe --tags

Проверка логов

screen -d -r gensyn

Удалить ноду

rm -rf rl-swarm

Troubleshooting:

1. В случае нехватки оперативной памяти (нода останавливается с ошибкой ./run_rl_swarm.sh: Killed):

Смотрим, есть ли уже активный файл подкачки:

swapon --show

Отключаем файл для изменения:

sudo swapoff /swapfile

Вводим новое значения файла, вместо xx укажите сколько гигабайт хотите выделить под файл подкачки:

 sudo fallocate -l xxG /swapfile

Подтверждаем изменение:

sudo mkswap /swapfile

Включаем файл подкачки:

sudo swapon /swapfile

2. В случае ошибки: [ERROR] [hivemind.dht.dht ._ run:130] [Errno 11] Resource temporarily unavailable ....EOFError: Ran out of input:

Переходим в директорию

cd rl-swarm

Делаем необходимое изменение в rg-swarm.yaml

sed -i -E 's/(num_train_samples:\s*)2/\1 1/' rgym_exp/config/rg-swarm.yaml

Перезапускаем ноду

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