Как ставить
- 👤 Сам, руками — читай этот README по порядку: подготовка VPS → установка → настройка в Telegram.
- 🤖 Через AI-агента (Claude Code, Cursor и т.п.) — открой AGENTS.md. Там протокол под автоматизацию: какие три значения спросить у пользователя, как запустить установщик через SSH, как проверить успех.
Что нужно
- VPS — Ubuntu 22.04+, 1 GB RAM. Заходишь как угодно: пароль, ключ, web-консоль панели хостера — без разницы.
- Telegram-бот — создай у @BotFather, сохрани токен.
- Свой Telegram-ID — узнай у @userinfobot.
После установки бот сам спросит ключи (бесплатные/дешёвые):
- Jina — эмбеддинги (free tier 10M токенов, non-commercial)
- Deepgram — голос → текст ($200 free)
- OpenRouter — LLM (есть
:freeмодели) - GitHub Personal Access Token — для бэкапов
Подготовка VPS (опционально)
Купил VPS, есть только IP + root + пароль? Я опубликовал отдельный скилл для безопасной первичной настройки сервера: создаст non-root юзера, сгенерит SSH-ключ, поднимет firewall и заблокирует root + парольный SSH в самом конце — только после того, как новый ключ проверенно работает с твоего ноута. Lockout-by-typo структурно невозможен.
1. Поставь скилл (один раз, на свой ноут):
curl -fsSL https://raw.githubusercontent.com/AndyShaman/vps-setup-skill/main/install.sh | bash
2. Открой Claude Code и опиши задачу человеческими словами:
Купил VPS, вот письмо хостера, защити сервер.
Скилл проведёт через 14 шагов: от welcome-email до hardened production-ready сервера. Подробности — README скилла.
После этого возвращайся сюда и продолжай установкой.
Установка
Зайди на VPS любым удобным способом и выполни прямо там:
git clone https://github.com/AndyShaman/Soroka.git soroka
cd soroka
./bin/install
Скрипт спросит две вещи: токен бота и твой Telegram-ID. Поставит Docker
(если ещё нет), запустит контейнер soroka-bot и пропишет soroka-mcp в
/usr/local/bin/. Никакого rsync, --vps, ssh-copy-id — всё работает
прямо там, где ты сейчас сидишь.
После завершения открой Telegram, найди своего бота и отправь /start —
мастер проведёт через 6 шагов настройки в чате.
Команды бота
/start— мастер настройки (запускается один раз; повтор возобновляет с прерванного шага)/help— справка/status— текущие настройки и статистика/setjina,/setdeepgram,/setkey— заменить отдельный ключ/models— выбрать основную/fallback LLM/setgithub— заменить GitHub-токен и репо-зеркало/setvps— задать IP/юзера VPS (используется в/mcp)/setinbox— сменить канал-инбокс/export— выгрузить базу архивом/sync— синхронизировать сообщения канала, пометить удалённые записи/purge_list [дней]— составить список «к удалению» без удаления данных/purge_list_ext [дней]— составить подробный список «к удалению» с фрагментами всех записей/purge [дней]— физически удалить записи, помеченные на удаление не менее указанного числа дней назад/mcp— конфиг для Claude Desktop (MCP-сервер по SSH stdio)/cancel— прервать мастер/диалог
Архитектура
Канал «Избранное 2» ──→ Бот на VPS ──→ SQLite (FTS5 + sqlite-vec)
DM с ботом ──↗ ↑
│
Claude Desktop через MCP-stdio ──SSH──┘
Обновление
Зайди на VPS, перейди в папку с репо и выполни:
cd ~/soroka # или туда, куда ты делал git clone
./bin/update
Подтянет последний код через git pull, пересоберёт контейнер, обновит
soroka-mcp. Никаких аргументов.
Резервное копирование
Авто-бэкап (если GitHub-зеркало подключено): раз в сутки бот собирает
lite-архив (только SQLite-база, без вложений) и заливает в один и тот же
тег soroka-daily-latest в приватном репо — старый релиз
перезаписывается, размер репо не растёт.
Ручной /export собирает базу + вложения в zip:
- ≤ 50 MB — приходит прямо в Telegram.
- > 50 MB — без GitHub-зеркала: бот пришлёт «облегчённый» архив (только база) и
попросит включить зеркало через
/setgithub. С зеркалом: заливает полный архив GitHub Release в твой приватный репо и пришлёт ссылку плюс облегчённый локально.
Для AI-агентов
См. AGENTS.md — там точный протокол развёртывания через флаги.
Лицензия
MIT.
