👤 Сам, руками — читай этот 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.
Estrelas
13
Ferramentas
—
Disponibilidade
—
Что нужно
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 estrelas·
Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Perguntas
Como instalo Soroka?
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
Soroka precisa de uma chave de API?
Este registro não lista nenhuma variável de ambiente obrigatória.
Qual transporte Soroka usa?
Soroka roda localmente via stdio.
Quando Soroka foi verificado pela última vez?
Última verificação: 2026-10-28. Personal Telegram knowledge base — forward anything, search via DM. Hybrid SQLite + FTS5 + vector + voice, MCP server for Claude.