Установка ноды Gensyn

Время установки — 35 минут

Сложность установки — средняя

Эта нода очень зависима от вычислительной мощности вашего сервера. Если у вас на сервере стоят другие ноды, то есть большая вероятность, что она не поедет.
У нас в приватном сообществе многие арендуют отдельный сервер для неё, и максимум доставляют на него Titan Network

Помимо этого, нода достаточно капризная, и бывает "падает" с разными ошибками. В нашем сообществе PROFIT NODES мы решили эту проблему - написали скрипт для автоперезапуска ноды.

Содержание:

Аренда сервера

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

Установка ноды

Проверка работоспособности

Бэкап файла swarm.pem

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

• Нам понадобится сервер, обладающий 12 vCPU / 32 RAM. Подходящий по характеристикам нам сервер есть на хостинге play2go.
• Инструкция по регистрации и покупке сервера уже доступна, а ниже на скриншоте сервер, который нам нужен
• Обязательно выбираем Ubuntu 22

• Локацию сервера можете выбрать самостоятельно. Можно Нидерланды, можно Германию, можно Финляндию.

• Обновляем пакеты

sudo apt-get update && sudo apt-get upgrade -y

• Устанавливаем библиотеки и утилиты

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

• Устанавливаем Python

sudo apt install python3 python3-pip python3-venv python3-dev -y

• Проверяем версию Python, должно быть как на скриншоте ниже

python3 --version

• Устанавливаем Node.js

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

• Проверяем версии, должно быть как на скриншоте ниже

node -v && npm -v && yarn -v

• Устанавливаем 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

• Создаём файл подкачки на 10 GB

sudo fallocate -l 10G /swapfile 
sudo chmod 600 /swapfile 
sudo mkswap /swapfile 
sudo swapon /swapfile

• Проверяем её командой ниже, должно быть 9-10 Gi

free -h

• Вводим команду для клонирования репозитория Gensyn

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

• Создаём screen-сессию. После создания у нас откроется пространство, и не будет видно всё то что мы вводили до этого

screen -S gensyn

• Заходим в директорию ноды

cd ~/rl-swarm

• Создаём виртуальное окружение командой ниже (может занять 5-10 сек)

python3 -m venv .venv

• Активируем виртуальное окружение командой ниже (должно появиться (.venv) слева от root)

source .venv/bin/activate

• Запускаем ноду командой ниже

./run_rl_swarm.sh

• Видим такие логи, ожидаем их завершения

• Далее мы должны увидеть такую фразу в логах
  "Waiting for modal userData.json to be created..."
  если видим её, то нажимаем на клавиатуре клавиши Ctrl + A + D, тем самым мы временно покидаем скрин-сессию

• Если мы корректно покинули скрин-сессию, то мы должны увидеть слово detached

• Скачиваем localtunnel

sudo npm install -g localtunnel

• Получаем пароль (он должен совпадать с айпи вашего сервера)

curl https://loca.lt/mytunnelpassword

• Запускаем localtunnel на 3000 порту

lt --port 3000

• В ответ нам выдаёт временную ссылку, по которой мы должны перейти. Наводим на ссылку мышку, нажимаем на Ctrl и кликаем левой кнопкой мыши по этой ссылке. Она откроется в браузере по умолчанию

• На сайте вводим айпи нашего сервера (он же пароль) и нажимаем Click to Submit

• Нас встречает форма логина, нажимаем на Sign In

• Вводите почту — она будет являться нашим идентификатором. Через неё мы сможем заходить в дэшборд и просматривать результаты работы нашей ноды. Взаимодействие с проектом будет завязано на эту почту!

• Введите одноразовый код для входа, полученный на почту

• После ввода кода вы должны увидеть фразу "You are successfully logged in to the Gensyn Testnet"

• Далее открываем терминал, и нажимаем на клавиатуре Ctrl + C, чтобы отключить туннель

• Заходим в скрин-сессию, для этого вводим команду ниже и у нас появляются логи, ожидаем как они пройдут

screen -r gensyn

• Далее нам предложит вставить ключ от HuggingFace, отвечаем N и нажимаем Enter

• После у нас спросит, какую модель мы хотим использовать для обучения.
  На наших серверах поедет самая слабая модель, копируем её, вставляем в терминал, нажимаем Enter

Gensyn/Qwen2.5-0.5B-Instruct

• После у нас спросит, хотим ли мы участвовать в Prediction Market. Мы в приватном сообществе участвуем, отвечаем Y и нажимаем Enter

• Далее мы должны увидеть такие логи
• Красным цветом выделено подключение к Gensyn Testnet
• Жёлтым цветом выделены наши
  человекочитаемый идентификатор (три слова) и PeerID.
  Обязательно сохраняем их!

• Далее нормальное рабочее состояние ноды является появление этих логов. Рекомендуем первый час не закрывать терминал а последить за логами.

• Если логи в порядке и нода работает, можно корректно покинуть скрин-сессию.
  Нажимаем на клавиатуре клавиши Ctrl + A + D.
• Если мы корректно покинули скрин-сессию, то мы должны увидеть слово detached

1. Логи ноды должны быть такими как в этом пункте
   
   
   
2. После 4-х часов безотказной работы ноды, заходим в дэшборд и логинимся точно также, как логинились во время запуска ноды

Обязательно используем ту же самую почту, что и во время запуска ноды!

• Нажимаем на большую кнопку RL Swarm (1) и мотаем вниз. Мы должны увидеть нашу ноду (2), а также Participation и Training Rewards. Также, мы должны увидеть адрес (3), которые аффилирован с нашей нодой. Сохраняем его!

• Значения Participation и Training Rewards должны расти! В норме на подобном сервере Participation растут на 10-20 пунктов в сутки. Для Rewards нет точных данных, т.к. на момент написания гайда (12.11.2025) Rewards не начисляются никому уже неделю
• Важно! Эти значения примерные и актуальны если только нода работает всё время! Если у вас нода отвалилась, а вы не увидели этого, значит у вас будут другие значения!

Нам необходимо сделать бэкап нашей ноды — это файл swarm.pem. Благодаря этому файлу и почте с помощью которой вы логинились во время запуска, вы сможете запустить эту ноду на любом другом сервере!

• Заходим в раздел SFTP в Termius (нажимаем на него)

• Слева и справа у нас два окна, мы можем перемещать файлы с одного сервера на другой, или с нашего компьютера на сервер и обратно!

• Слева нажимаем Local (зелёная кнопка), выбираем Users -> имя вашего пользователя -> Downloads (чтобы путь был такой же как на скриншоте)

• Справа выбираем сервер, где только что устанавливали Gensyn

• Заходим в директорию rl-swarm, листаем вниз и видим файл swarm.pem
• Зажимаем его левой кнопкой мыши и переносим в левую часть, на наш локальный компьютер как на скриншоте

• Теперь файл swarm.pem оказался в директории загрузок у вас на компьютере. Можете перенести его в любую удобную для вас папку

• Проверить скрин-сессию можно командой ниже

screen -ls

• В норме должна быть 1 сессия и статус у неё должен быть Detached

• Если сессий несколько, или статус у неё Attached — значит нужно разбираться более конкретно. Пишите в комменты свои вопросы.

• Если сессий нет как на скриншоте ниже, значит
  выполняем инструкцию по ссылке

• Заход в скрин-сессию для проверки логов выполняется командой ниже

screen -r gensyn

• Остановка ноды выполняется таким образом. Нужно сначала зайти в скрин-сессию командой выше и в скрин-сессии нажать несколько раз Ctrl + C, чтобы завершить работу ноды

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

• Ваша нода может упасть с какой-нибудь ошибкой, например, с такой:

• В этом случае видим, что внизу появилась строчка
  "(.venv) root@xxxx:~/rl-swarm#"
• Если этой строчки нет, значит нам нужно 1-2 раза нажать комбинацию клавиш на клавиатуре Ctrl + C
• После этого должна появится эта строчка
• В таком случае, начинаем повторный запуск ноды с этого пункта

• Если вы случайно создали много скрин-сессий gensyn, то закрыть их можно этой универсальной командой

screen -ls | grep gensyn | awk -F. '{print $1}' | xargs -I {} screen -S {} -X quit

• Если скрин-сессии нет, значит нужно создать новую и запустить ноду в ней заново. Выполняем инструкцию ниже:

screen -S gensyn

cd ~/rl-swarm/ && source .venv/bin/activate

И начинаем повторный запуск ноды с этого пункта

Остались вопросы или столкнулись с ошибкой❓

Задавайте их в комментариях под этой статьёй — мы читаем всё и обязательно ответим!

Загляните в раздел с гайдами — там вы найдёте ещё больше инструкций связанных с нодами и не только.