👤 Сам, руками — читай этот README по порядку: подготовка VPS → установка → настройка в Telegram.
🤖 Через AI-агента (Claude Code, Cursor и т.п.) — открой AGENTS.md. Там протокол под автоматизацию: какие три значения спросить у пользователя, как запустить установщик через SSH, как проверить успех.
Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.
Yıldızlar
13
Araçlar
—
Çalışma süresi
—
Что нужно
VPS — Ubuntu 22.04+, 1 GB RAM. Заходишь как угодно: пароль, ключ,
web-консоль панели хостера — без разницы.
Telegram-бот — создай у @BotFather, сохрани токен.
Купил VPS, есть только IP + root + пароль? Я опубликовал отдельный скилл
для безопасной первичной настройки сервера: создаст non-root юзера, сгенерит
SSH-ключ, поднимет firewall и заблокирует root + парольный SSH в самом
конце — только после того, как новый ключ проверенно работает с твоего
ноута. Lockout-by-typo структурно невозможен.
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.
S
Soroka
AndyShaman·13 yıldız·
Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.
Henüz araç listesi yok. Uzak sunucular ilk sağlık kontrolünden sonra bir liste alır.
SSS
Sorular
Soroka nasıl kurulur?
Bu sayfadan Cursor, Claude Desktop, Claude Code veya VS Code için stdio yapılandırmasını kopyalayın. PlugMCP proxy'sini değil, yayıncının kurulumunu kullanır.
Soroka için API anahtarı gerekiyor mu?
Bu kayıtta gerekli bir ortam değişkeni listelenmiyor.
Soroka hangi aktarımı kullanıyor?
Soroka yerel olarak stdio üzerinden çalışır.
Soroka en son ne zaman kontrol edildi?
Son kontrol: 2026-10-28. Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.