_ 
$ ssh ruslan@hermes.sailor.bar

Руслан_

AI-агент для русскоязычных.
Помогает войти в IT без английского.
Работает на телефоне, ноутбуке, сервере.

[ Инструкции ] [ Скиллы ]

~/Руслан/mission.md

## Миссия

Руслан — это открытый AI-агент для русскоязычной аудитории. Мы помогаем молодёжи и студентам войти в программирование и технологии без знания английского языка.

Наша цель — дать каждому русскоязычному человеку личного AI-помощника, который говорит на его языке, понимает контекст и помогает развиваться. Мы верим, что технологии должны быть доступны всем, независимо от языкового барьера.

Помощник
~/Руслан/ASSISTANT.sh [ + ]
Установка
📱

Android (Termux)

Telegram-бот, голосовые сообщения, автозапуск, HyperOS fix.

$ curl -fsSL hermes.sailor.bar/android | bash
~/Руслан/INSTALL_DETAILED.md — Android
# 📱 Руслан на Android — подробная установка # ⏱ 5-10 минут + компиляция Rust 15-40 мин ──────────────────────────────────────── ⚠ ВАЖНО: На HyperOS (Xiaomi/Redmi/Poco) Termux обязательно настроить, иначе система убьёт процесс в фоне! ──────────────────────────────────────── 1Установи F-Droid F-Droid — магазин приложений без рекламы. Скачай APK и установи: https://f-droid.org/F-Droid.apk ИЛИ открой в браузере телефона и нажми Download: https://f-droid.org 📌 Разреши установку из «неизвестных источников» когда телефон спросит ──────────────────────────────────────── 2Установи Termux через F-Droid Открой F-Droid → поиск «Termux» → Установить Прямая ссылка: https://f-droid.org/packages/com.termux/ 📌 НЕ ставь Termux из Google Play — там старая версия! ──────────────────────────────────────── 3Настрой Termux для HyperOS/Xiaomi ⚠ БЕЗ ЭТОГО ШАГА Termux будет убит через 5 минут! # a. Открой Настройки → Батарея → Фоновые процессы Найди Termux → отключи «Ограничить фоновую активность» # b. Настройки → Приложения → Termux → Автозапуск → ВКЛ # c. Настройки → Режим разработчика → Включи «Не убивать фоновые приложения» (Если нет режима разработчика: Настройки → О телефоне → Версия MIUI/HyperOS → нажми 7 раз) # d. Закрепи Termux в памяти: Открой список последних приложений → Найди Termux → нажми и удерживай → Заблокировать ──────────────────────────────────────── 4Запусти Termux Просто открой приложение Termux. Дай разрешения на доступ к файлам (если спросит). 📌 Должен увидеть: «~ $» и мигающий курсор ──────────────────────────────────────── 5Установи Руслан одной командой Вставь эту команду в Termux: curl -fsSL https://hermes.sailor.bar/android | bash Установщик сделает всё сам: • Обновит пакеты Termux [1/8] • Установит Python, Git, Rust [2/8] • Скачает и распакует Руслан [3/8] • Установит через pip [4/8] • Скомпилирует зависимости [5/8] ← 15-40 мин • Предустановит discord.py [6/8] • Создаст конфигурацию [7/8] • Настроит автозапуск [8/8] ⏳ Шаг [5/8] — компиляция Rust — самый долгий! Закрой телефон, сделай чай ☕. ──────────────────────────────────────── 6Первый запуск После установки: 1. Закрой и открой Termux заново (или выполни: source ~/.bashrc) 2. Запусти: hermes gateway run --accept-hooks 3. Руслан сам запустит мастер настройки: • Выбери провайдера (DeepSeek / OpenRouter / ...) • Введи API-ключ (или выбери :free модель) • Настрой Telegram-бота 4. Profit! 🎉 ──────────────────────────────────────── 7Автозапуск при загрузке Чтобы Руслан запускался сам при включении телефона: pkg install termux-boot mkdir -p ~/.termux/boot cp ~/Руслан/android/services/boot-script.sh ~/.termux/boot/ ──────────────────────────────────────── 8Обновление ruslan-update # 🔗 Полезные ссылки • F-Droid: https://f-droid.org/F-Droid.apk • Termux: https://f-droid.org/packages/com.termux/ • Бесплатная LLM: https://hermes.sailor.bar/llm
~/Руслан/INSTALL.md — Android
# 1. Установи Termux из F-Droid https://f-droid.org/packages/com.termux/ # 2. Запусти Termux и выполни: curl -fsSL https://hermes.sailor.bar/android | bash # 3. Запусти Руслана: hermes gateway run --accept-hooks При первом запуске — мастер сам спросит провайдера # Обновление: ruslan-update
🍏

macOS

Любая версия. Русский язык из коробки. Российские LLM.

$ curl -fsSL hermes.sailor.bar/mac | bash
~/Руслан/INSTALL_DETAILED.md — macOS
# 🍏 Руслан на macOS — подробная установка # ⏱ 3-5 минут ──────────────────────────────────────── 1Установи Homebrew (если нет) Открой Терминал (Finder → Программы → Утилиты → Терминал) /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 📌 Homebrew — пакетный менеджер для Mac, нужен для Python и Git ──────────────────────────────────────── 2Установи Руслан одной командой curl -fsSL https://hermes.sailor.bar/mac | bash ──────────────────────────────────────── 3Первый запуск source ~/.zshrc && ruslan ИЛИ: hermes gateway run --accept-hooks Руслан сам запустит мастер настройки: • Выбери провайдера • Введи API-ключ • Настрой Telegram-бота ──────────────────────────────────────── 4Обновление ruslan-update # 🔗 Полезные ссылки • Homebrew: https://brew.sh • Бесплатная LLM: https://hermes.sailor.bar/llm
~/Руслан/INSTALL.md — macOS
# 1. Установи Homebrew (если нет): /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 2. Установи Руслана: curl -fsSL https://hermes.sailor.bar/mac | bash # 3. Запусти: source ~/.zshrc && ruslan При первом запуске — мастер сам спросит провайдера # Обновление: ruslan-update
🪟

Windows

Нативный Python. Без WSL.

$ [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr hermes.sailor.bar/win).Content
~/Руслан/INSTALL_DETAILED.md — Windows
# 🪟 Руслан на Windows — подробная установка # ⏱ 3-5 минут ──────────────────────────────────────── 1Открой PowerShell Нажми Win+X → Windows Terminal (или PowerShell). Права администратора НЕ нужны. ──────────────────────────────────────── 2Запусти установку (одна строка) Скопируй и вставь в PowerShell: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr hermes.sailor.bar/win).Content 📌 Если ошибка — выполни сначала: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass Затем: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr hermes.sailor.bar/win).Content Установщик сам: • Проверит Python (если нет — скачает и установит) • Скачает Руслан • Установит через pip • Настроит конфиг • Добавит алиас в PowerShell профиль ──────────────────────────────────────── 3Первый запуск После установки в том же PowerShell: hermes gateway run --accept-hooks Руслан сам запустит мастер настройки: • Выбери провайдера (DeepSeek / OpenRouter / Groq) • Введи API-ключ • Настрой Telegram-бота (токен от BotFather) ──────────────────────────────────────── 4Повторный запуск Перезапусти PowerShell и набери: ruslan Это алиас, который добавил установщик. ──────────────────────────────────────── 5Обновление ruslan-update Или просто перезапусти установщик. # 🔗 Полезные ссылки • Бесплатная LLM: https://hermes.sailor.bar/llm • Полная инструкция: https://hermes.sailor.bar/docs/
~/Руслан/INSTALL.md — Windows
# 1. Открой PowerShell (Win+X) Права админа НЕ нужны # 2. Запусти установку (одна строка): [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr hermes.sailor.bar/win).Content # 3. Запусти Руслан: hermes gateway run --accept-hooks При первом запуске — мастер сам спросит провайдера и API-ключи # Обновление: ruslan-update Или запусти установщик снова
🐧

Linux

VPS, сервер, десктоп. Docker. Российские LLM.

$ curl -fsSL hermes.sailor.bar/linux | bash
~/Руслан/INSTALL_DETAILED.md — Linux
# 🐧 Руслан на Linux — подробная установка # ⏱ 3-5 минут ──────────────────────────────────────── 1Установи Python и Git (если нет) # Debian / Ubuntu / Pop!_OS: sudo apt update && sudo apt install python3 python3-pip python3-venv git curl -y # Fedora: sudo dnf install python3 python3-pip git curl -y # Arch: sudo pacman -S python python-pip git curl --noconfirm # Alpine: sudo apk add python3 py3-pip git curl ──────────────────────────────────────── 2Установи Руслан одной командой curl -fsSL https://hermes.sailor.bar/linux | bash ──────────────────────────────────────── 3Первый запуск source ~/.bashrc && ruslan ИЛИ: hermes gateway run --accept-hooks Руслан сам запустит мастер настройки: • Выбери провайдера • Введи API-ключ • Настрой Telegram-бота ──────────────────────────────────────── 4Обновление ruslan-update # 🔗 Полезные ссылки • Бесплатная LLM: https://hermes.sailor.bar/llm
~/Руслан/INSTALL.md — Linux
# 1. Установи Python и git (если нет): # Debian/Ubuntu: sudo apt install python3 python3-pip python3-venv git curl # 2. Установи Руслана: curl -fsSL https://hermes.sailor.bar/linux | bash # 3. Запусти: source ~/.bashrc && ruslan При первом запуске — мастер сам спросит провайдера # Обновление: ruslan-update
~/Руслан/config.yaml

## Российские LLM-провайдеры

Прямые API, не через посредников. Выбери один.

DeepSeek YandexGPT GigaChat OpenRouter OpenCode Ollama

^ активные = прямые API, без OpenRouter

Бесплатная LLM

Три способа запустить ИИ без денег.

🦙 Ollama — локально, без ключа, без интернета $ brew install ollama && ollama pull qwen2.5:1.5b

Скачать: macOS · Windows · Linux: curl -fsSL https://ollama.com/install.sh | sh

🌐 OpenRouter :free — облако, регистрация 2 мин $ export OPENROUTER_API_KEY=***

[ Все способы ]

~/Руслан/FREE_LLM.md
# 🔑 Бесплатная LLM для Руслана ## 🦙 Способ 1: Ollama — ЛОКАЛЬНО, БЕЗ КЛЮЧА # Скачать Ollama: • macOS: https://ollama.com/download/Ollama.dmg • Windows: https://ollama.com/download/OllamaSetup.exe • Linux: curl -fsSL https://ollama.com/install.sh | sh # Шаг 1: brew install ollama # Mac curl -fsSL https://ollama.com/install.sh | sh # Linux # Шаг 2: скачай модель ollama pull qwen2.5:1.5b # 1.5 ГБ, есть русский # Шаг 3: настрой config.yaml model.default: qwen2.5:1.5b provider: ollama base_url: http://localhost:11434/v1 # Всё! Руслан работает без интернета и без ключей. # ❌ Не подходит для Android — модель на телефоне медленная ──────────────────────────────────────── ## 🌐 Способ 2: OpenRouter :free — облако, 2 минуты # Шаг 1: зарегистрируйся и получи ключ https://openrouter.ai/keys Нажми «Create API Key», скопируй sk-or-v1-... # Шаг 2: выбери бесплатную модель qwen/qwen3-coder:free — код, универсальное (русский ✅) deepseek/deepseek-r1:free — рассуждения (русский ✅) # Шаг 3: настрой config.yaml model.default: qwen/qwen3-coder:free provider: openrouter # В .env добавь: OPENROUTER_API_KEY=sk-or-v1-твой-ключ ──────────────────────────────────────── ## ⚡ Способ 3: Groq — быстрые модели # Шаг 1: получи ключ на console.groq.com/keys # Шаг 2: настрой config.yaml model.default: llama-3.3-70b-versatile provider: groq # В .env добавь: GROQ_API_KEY=... ──────────────────────────────────────── ## ✅ Проверка Напиши боту: /status Если видишь свою модель — всё работает 🎉 ## 🆘 Не работает? 1. config.yaml должен быть в ~/.hermes/ (комп) или ~/.config/hermes/ (Android) 2. Ключ без кавычек в .env 3. На OpenRouter модель с :free — qwen/qwen3-coder:free 4. Перезапусти Руслана после изменений
Возможности

🇷🇺 Русский язык

Все команды, подсказки, интерфейс — на русском. Из коробки.

🤖 Российские LLM

DeepSeek, YandexGPT, GigaChat — прямые API.

📱 Везде

Android, macOS, Windows, Linux. Одна команда.

🔧 Просто

curl-скрипт ставит всё автоматически.

⚡ Автозапуск

Gateway сам восстанавливается. HyperOS fix.

🔑 Бесплатно

Ollama — без ключа. OpenRouter — :free модели.

Руслан — форк Hermes Agent (MIT) от Nous Research

[ На главную ] [ Инструкции ] [ Скиллы ] [ Бесплатная LLM ] [ Уроки автора ] [ Правовая информация ]