Skoobi mascot
v1.2 · Open source · TypeScript

Личный AI-ассистент
прямо в Telegram

Skoobi Agent — runtime для персональных ассистентов в Telegram. Codex CLI как основной провайдер, Claude SDK как fallback. Изоляция тенантов, квоты, провенанс памяти.

Установить GitHub
$ curl -fsSL https://github.com/barmashovdmitrii-droid/skoobi-agent/releases/latest/download/install.sh | bash
Возможности

Всё что нужно для production-ассистента

Не игрушка. Tenant isolation, аудит, квоты, провенанс памяти — встроены.

Telegram-first

Основной канал — Telegram-бот. Текст, голос, фото, документы. Без веб-формы и SaaS-обёрток.

Codex + Claude

Codex subscription CLI как основной runtime, автоматический fallback на Claude SDK при ошибках и недоступности.

Tenant isolation

Жёсткая изоляция тенантов. Гостевой тенант не читает чужую память, .env, БД и auth-данные.

Внутренние кредиты

Квоты в собственных кредитах, не в долларах. Аудит сырых usage-данных отдельно. Никаких сюрпризов в счёте.

Провенанс памяти

Каждая запись помечена tenant_id, sender_id, source_type, confidence. Удаление — только по точному подтверждению.

Security model

Модель — не граница доверия. Доступ к инструментам решает политика и аудит, а не LLM.

Архитектура

Как обрабатывается сообщение

Каждый Telegram-апдейт проходит через политику, квоты и аудит до того, как попадёт в модель.

Telegram update ↓ tenant registry ↓ event store ↓ quota & safety pre-handlers ↓ runtime selection ↓ Skoobi live for guest tenants primary: codex_subscription_cli fallback: claude_sdk ↓ Telegram response ↓ usage ledger / model traces / audit events
Провайдеры

Два независимых runtime

Codex для скорости и контекста. Claude для надёжности fallback.

PRIMARY

Codex Subscription CLI

Runtime-адаптер через локальный codex CLI. Не читает ~/.codex/auth.json, не передаёт инструменты Skoobi в Codex.

  • Запуск в изолированной scratch-директории
  • Нет доступа к groups/, store/, .env, ~/.ssh
  • Конфиг через SKOOBI_CODEX_* env-переменные
FALLBACK

Claude SDK

Активируется при таймауте, rate-limit, ошибке модели или отсутствии Codex. Один видимый ответ, без двойных списаний.

  • Та же политика и квоты
  • Один user-visible ответ за запрос
  • Без двойного списания кредитов
Команды пользователя

Квоты прямо из чата

/limit

Текущий лимит

/balance

Остаток кредитов

«Сколько осталось?»

Естественный язык — RU/EN

Запусти своего ассистента

Node 22+, Telegram bot token — больше ничего не нужно.

Открыть GitHub Документация