$ ssh ruslan@ruslan.team

Руслан – российский AI-агент с памятью и автоматизацией_

Персональный AI-агент, который работает на вас.
Помнит контекст, выполняет задачи по расписанию,
работает 24/7. Self-hosted, открытый код.

[ Установить ] [ Инструкции ] [ Скиллы ] [ FAQ ] [ Форум ]
Экосистема

Руслан — это не просто чат-бот. Это полноценная экосистема с постоянной памятью, навыками, API и открытым кодом.

📱
Android
приложение
💬
Telegram
бот
🌐
Web
интерфейс
🧩
Навыки
навыки
🧠
Постоянная память
память
🔗
API
API
🔓
Open Source
открытый код
~/Руслан/COMMUNITY.md

👥 Сообщество – звёзды, issues, чат

⭐ GitHub valldun1/ruslan 🟢 Issues 🔑 MIT License 🐙 Open Source
Возможности

🤖 Автономный агент

Выполняет задачи без твоего контроля. Пишет код, работает с файлами, запускает команды, управляет cron.

💬 5 мессенджеров

Telegram, Discord, IRC, Slack, Mattermost. Один агент – везде, где ты общаешься.

🛡 Русский язык

Интерфейс, промпты, команды – всё на русском. Не нужно знать английский.

🔓 Open Source (MIT)

Полностью открытый код. Можно модифицировать, форкать, использовать в коммерции.

📱 Все платформы

Linux, macOS, Windows (WSL), Android (Termux). Работает на телефоне, ноутбуке, сервере.

🔄 Мультимодельность

Разные модели для разных задач. DeepSeek для кода, GLM для планирования, Claude для ревью.

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

Исходный код Руслана открыт – лицензия MIT. Форкай, изучай, предлагай улучшения, сообщай о багах.

🐙 GitHub [ Issues ]

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

Руслан – это не замена ChatGPT. Мы строим платформу поверх LLM-моделей. Любая модель может измениться – Руслан остаётся вашим агентом, памятью и автоматизацией.

// Когда нужен ChatGPT
💬 Быстрые ответы на вопросы
✍️ Генерация текста и перевод
🔹 Разовые задачи без контекста
// Когда нужен Руслан
🧠 Постоянная память
⏰ Автоматизация по расписанию
🔒 Self-hosted, ваши данные
💬 Telegram, Discord, IRC
🧩 Собственные навыки (Skills)
🤖 Любые LLM-модели

Мы не конкурируем с моделями. Мы строим платформу для их эффективного использования.

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

Миссия

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

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

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

Android (Termux)

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

curl -fsSL ruslan.team/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 и Termux:Boot через F-Droid Открой F-Droid → поиск «Termux» → Установить
Затем поиск «Termux:Boot» → Установить тоже
Прямые ссылки: https://f-droid.org/packages/com.termux/ https://f-droid.org/packages/com.termux.boot/ 📌 НЕ ставь 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://ruslan.team/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 – самый долгий! Закрой телефон, сделай чай ☕. ⚠ Если установка прервалась – просто запусти команду снова: curl -fsSL https://ruslan.team/android | bash Установщик продолжит с того места, где остановился. ──────────────────────────────────────── 6Настройка (первый запуск) После установки: 1. Закрой и открой Termux заново (или выполни: source ~/.bashrc) 2. Запусти мастер настройки: ruslan setup 3. Мастер шаг за шагом спросит: • Выбери провайдера (DeepSeek / OpenRouter / ...) • Введи API-ключ (или выбери :free модель) • Настрой Telegram-бота 4. Запусти Руслана: ruslan 5. 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://ruslan.team/llm
~/Руслан/INSTALL.md – Android
# 1. Установи Termux из F-Droid https://f-droid.org/packages/com.termux/ # 2. Запусти Termux – выполни по одной: termux-change-repo → выбери зеркало (например, Grimler) pkg update -y pkg install curl -y # 3. Установи Руслан: curl -fsSL https://ruslan.team/android | bash # 4. Мастер настройки (провайдер, ключи, Telegram): ruslan setup # 5. Запусти Руслана: ruslan # Обновление: ruslan update
🍏

macOS

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

curl -fsSL ruslan.team/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://ruslan.team/mac | bash ──────────────────────────────────────── 3Настройка (первый запуск) source ~/.zshrc && ruslan setup ИЛИ: ruslan setup Мастер шаг за шагом спросит: • Выбери провайдера • Введи API-ключ • Настрой Telegram-бота ──────────────────────────────────────── 4Запуск Руслана После настройки: source ~/.zshrc && ruslan ИЛИ: ruslan ──────────────────────────────────────── 5Обновление ruslan update # 🔗 Полезные ссылки • Homebrew: https://brew.sh • Бесплатная LLM: https://ruslan.team/llm
~/Руслан/INSTALL.md – macOS
# 1. Установи Homebrew (если нет): /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" # 2. Установи Руслана: curl -fsSL https://ruslan.team/mac | bash # 3. Мастер настройки (провайдер, ключи, Telegram): source ~/.zshrc && ruslan setup # 4. Запусти Руслана: ruslan # Обновление: ruslan update
🐧

Linux

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

curl -fsSL ruslan.team/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://ruslan.team/linux | bash ──────────────────────────────────────── 3Настройка (первый запуск) source ~/.bashrc && ruslan setup ИЛИ: ruslan setup Мастер шаг за шагом спросит: • Выбери провайдера • Введи API-ключ • Настрой Telegram-бота ──────────────────────────────────────── 4Запуск Руслана После настройки: source ~/.bashrc && ruslan ИЛИ: ruslan ──────────────────────────────────────── 5Обновление ruslan update # 🔗 Полезные ссылки • Бесплатная LLM: https://ruslan.team/llm
~/Руслан/INSTALL.md – Linux
# 1. Установи Python и git (если нет): # Debian/Ubuntu: sudo apt install python3 python3-pip python3-venv git curl # 2. Установи Руслана: curl -fsSL https://ruslan.team/linux | bash # 3. Мастер настройки (провайдер, ключи, Telegram): source ~/.bashrc && ruslan setup # 4. Запусти Руслана: ruslan # Обновление: ruslan update
🪟

Windows

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

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr ruslan.team/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 ruslan.team/win).Content 📌 Если ошибка – выполни сначала: Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass Затем: [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr ruslan.team/win).Content Установщик сам: • Проверит Python (если нет – скачает и установит) • Скачает Руслан • Установит через pip • Настроит конфиг • Добавит алиас в PowerShell профиль ──────────────────────────────────────── 3Настройка (первый запуск) После установки в том же PowerShell: ruslan setup Мастер шаг за шагом спросит: • Выбери провайдера (DeepSeek / OpenRouter / Groq) • Введи API-ключ • Настрой Telegram-бота (токен от BotFather) ──────────────────────────────────────── 4Запуск Руслана После настройки перезапусти PowerShell и набери: ruslan Это алиас, который добавил установщик. ──────────────────────────────────────── 5Обновление ruslan update Или просто перезапусти установщик. # 🔗 Полезные ссылки • Бесплатная LLM: https://ruslan.team/llm • Полная инструкция: https://ruslan.team/docs/
~/Руслан/INSTALL.md – Windows
# 1. Открой PowerShell (Win+X) Права админа НЕ нужны # 2. Запусти установку (одна строка): [Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iex (iwr ruslan.team/win).Content # 3. Мастер настройки (провайдер, ключи, Telegram): ruslan setup # 4. Запусти Руслана: ruslan # Обновление: ruslan update Или запусти установщик снова
~/Руслан/config.yaml

LLM-провайдеры

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

DeepSeek YandexGPT GigaChat OpenRouter OpenCode Ollama

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

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

Бесплатная 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 должен быть в ~/.ruslan/ (комп) или ~/.hermes/ (Android) 2. Ключ без кавычек в .env 3. На OpenRouter модель с :free – qwen/qwen3-coder:free 4. Перезапусти Руслана после изменений

Основан на открытом коде Hermes Agent (MIT)

🐙 Исходный код Руслана на GitHub

На главную Инструкции Блог После установки Скиллы Бесплатная LLM 🎁 Домен в подарок Уроки автора Видение и цель Правовая информация 🗺 Карта экосистемы Форум