Archivarius

Автономный архивариус-оркестратор базы знаний экосистемы Razarabotka/.

Что делает: принимает входящую информацию (заметки, Things 3 задачи, ссылки, транскрипты), маршрутизирует её в нужные файлы нужных проектов, выявляет и чиниt фрактальные разрывы в базе знаний.

Интерфейс: Telegram-бот.
Деплой: Timeweb VPS (<SERVER_IP>, общий сервер с TeleTranscribe), домен archivarius.neuroimpuls.ru (nginx + Let's Encrypt), uvicorn на порту 8090, systemd archivarius-webhook.service.
LLM: Claude через Claude Code OAuth-подписку (provider: claude_code) — Sonnet для тяжёлых sub-agents, Haiku для лёгких. Yandex/OpenRouter выведены.

---

Быстрый старт

# 1. Клонировать репо
git clone https://github.com/AgentSmoki/Archivarius

# 2. Настроить окружение
cp .env.example .env
# Заполнить .env

# 3. Инициализировать граф БД (Kuzu)
python migrations/001_kuzu_init.py

# 4. Установить зависимости
pip install -r requirements.txt

# 5. Запустить (dev)
python -m src.bot

# Production: systemd unit (см. docs/deploy_guide.md)

Добавить проект

Написать боту в Telegram:

/add_project https://github.com/AgentSmoki/Avito_Orchestrator

Архитектура

src/
  bot.py              — Telegram (aiogram 3.x)
  webhook_server.py   — FastAPI: TG + GitHub webhooks
  recursive_router.py — Zoom Out → Zoom In (Haiku → Sonnet)
  gap_detector.py     — 4 типа фрактальных разрывов
  fractal_indexer.py  — frontmatter → Kuzu
  graphify_bridge.py  — интеграция с graphify
  writer.py           — safe edit + git commit
  synthesizer.py      — bottom-up digest
  scheduler.py        — APScheduler циклы
  reporter.py         — TG отчёты

bridge/
  things_mcp_server.py — Mac-сторона: Things 3 → MCP (Этап 2)

Подробно: vision.md

Примечание

Значения инфраструктуры (адреса серверов, пути, идентификаторы ботов) в конфигах и документации — иллюстративные. Профили пользователя и список проектов заполняются локально через onboarding и в репозиторий не попадают.

Лицензия

MIT — см. LICENSE.