👤 Сам, руками — читай этот 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.
Estrellas
13
Herramientas
—
Disponibilidad
—
Что нужно
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 estrellas·
Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo Soroka?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Soroka necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Soroka?
Soroka se ejecuta localmente por stdio.
¿Cuándo se comprobó Soroka por última vez?
Última comprobación: 2026-10-28. Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.