diff --git a/scripts/README.md b/scripts/README.md
new file mode 100644
index 00000000..2bc203fc
--- /dev/null
+++ b/scripts/README.md
@@ -0,0 +1,17 @@
+# scripts
+
+## setup_gensyn.sh
+
+Однорядковий інсталер, який:
+
+1. Оновлює систему та ставить `python3.10`, `git`, `screen`.  
+2. Клонує репозиторій **gensyn-ai/rl-swarm** у `~/rl-swarm`.  
+3. Створює Python-venv, встановлює залежності, патчить `protobuf==3.20.3`.  
+4. Запускає воркер у фоні (`screen -dmS gensyn ./run_rl_swarm.sh`).
+
+```bash
+curl -sSL https://raw.githubusercontent.com/VasilenkoViktor/rl-swarm/main/scripts/setup_gensyn.sh | bash
+```
+
+> ⚠️ Скрипт призначений для Ubuntu 22.04 / Debian 12 і тестований у WSL 2 та на VPS (Contabo, DigitalOcean).  
+> > Файл `swarm.pem` після запуску зберігається у `~/.gensyn/` — не забудьте зробити резервну копію, якщо плануєте переносити вузол.
diff --git a/scripts/setup_gensyn.sh b/scripts/setup_gensyn.sh
new file mode 100644
index 00000000..0f969ed9
--- /dev/null
+++ b/scripts/setup_gensyn.sh
@@ -0,0 +1,26 @@
+#!/usr/bin/env bash
+# One-liner installer for Gensyn RL-Swarm
+# Usage:
+#   curl -sSL https://raw.githubusercontent.com/VasilenkoViktor/rl-swarm/main/scripts/setup_gensyn.sh | bash
+
+set -e
+
+echo "[1/5] Updating system and installing base packages…"
+sudo apt-get update -y
+sudo apt-get install -y python3.10 python3-venv git screen
+
+echo "[2/5] Cloning rl-swarm…"
+git clone https://github.com/gensyn-ai/rl-swarm.git ~/rl-swarm || true
+cd ~/rl-swarm
+
+echo "[3/5] Creating venv and installing Python deps…"
+python3 -m venv .venv
+source .venv/bin/activate
+pip install --upgrade pip
+pip install -r requirements.txt
+pip install protobuf==3.20.3        # patch mismatched-protobuf bug
+
+echo "[4/5] Launching worker inside screen…"
+screen -dmS gensyn bash -c "./run_rl_swarm.sh"
+
+echo "[5/5] Done!  Attach logs any time:  screen -r gensyn"