Files
buryan-infra/docs/HUB-BOTS.md
T
buryan-agent 91df3e60bf Флот Matrix-ботов: медиа, фото, книги, дом, инфраструктура, поиск, дайджест, камеры
Восемь ботов в пространстве Buryan Hub, по комнате на домен. Каждый
отвечает на !help списком своих команд и показывает реальные данные:
Jellyfin (Items/Counts), Sonarr/Radarr (очередь, диски, нехватка),
Seerr (заявки), Prometheus (службы, тревоги), Immich/Calibre/Navidrome
и Home Assistant — через pct.

Ежедневная сводка в 09:00 (cron) в комнату «Дайджесты».

Важное: все библиотеки пусты (0 фильмов, 0 фото, 0 книг, 0 треков),
Frigate не развёрнут — боты говорят об этом честно и подсказывают,
как наполнить. Диск один, внешних хранилищ нет.

Секреты: /etc/hub-bots/bots.env (600), /root/hub-bots/ALL-SECRETS.txt (600),
зашифрованная копия ops/secrets-enc/hub-bots-secrets.age.
2026-10-19 16:37:38 +03:00

5.7 KiB
Raw Blame History

Buryan Hub: флот ботов и контентная платформа

Что сделано 19.10.2026: боты в Matrix, пространство с комнатами, единая карта сервисов, ежедневная сводка, ключи в одном месте.


1. Важное открытие: библиотеки пусты

Прежде чем строить «контентную архитектуру», проверил, что в сервисах есть:

Сервис Содержимое
Jellyfin (медиатека) 0 фильмов, 0 сериалов, 0 серий, 0 альбомов
Plex папка /opt/plex/media пуста
Navidrome (музыка) 0 треков, 0 альбомов
Immich (фото) 0 снимков, 0 альбомов
Calibre (книги) 0 книг
Home Assistant 8 сущностей
Frigate не развёрнут

Диск один (NVMe 476 ГБ), внешних хранилищ нет. То есть платформа построена, но контентом не наполнена — интеграция пока показывает честные нули и подсказки, как наполнить.

Что нужно, чтобы ожило:

  1. Медиа — положить файлы в /media/movies, /media/series, /media/music (CT 103) и запустить сканирование. Для автоматических загрузок — настроить в Sonarr/Radarr клиент загрузки (qBittorrent/ Transmission) и индексаторы в Prowlarr.
  2. Фото — поставить приложение Immich на телефоны, включить автозагрузку.
  3. Книги — загрузить через books.buryans.ru.
  4. Дом — добавить устройства в Home Assistant.
  5. Frigate — нужны RTSP-адреса камер; без них сервер наблюдения не имеет смысла.

2. Пространство и комнаты

Пространство Buryan Hub в Matrix, внутри 9 комнат:

Комната Бот Что там
Медиа @media фильмы, сериалы, очередь загрузок, заявки
Фото @photo Immich: снимки, альбомы
Книги @book библиотека, поиск, новинки
Дом @home Home Assistant: сущности, состояние
Инфраструктура @infra службы, тревоги, диски, резервные копии, состав библиотек
Поиск @search поиск по медиа, книгам и документам сразу
Дайджесты @digest ежедневная сводка в 09:00 и карта платформы
Камеры @cam Frigate (когда появится)

Люди приглашены: @akadmin, @polina, @elena, @nikita, @sergey, @alextest.

3. Команды ботов

У каждого бота !help показывает свои команды. Коротко:

Бот Команды
media !stats !new !find <текст> !now !queue !requests !disk !wanted !paths
photo !stats !space
book !stats !new !find <текст>
home !stats !status
infra !status !alerts !disk !backups !content !services
search !s <текст>
digest !digest !map
cam !status

4. Как это устроено

/opt/hub-bots/            ← код на узле Proxmox
  hub/
    matrix.py             клиент Matrix: отправка, длинный опрос
    sources.py            клиенты сервисов (Jellyfin, Sonarr, Radarr, Seerr, Prometheus)
    local.py              чтение баз через pct (Navidrome, Calibre, Immich, HA)
    catalog.py            карта сервисов и состав библиотек
    bots.py               все боты и их команды
    main.py               запуск флота
  digest.py               ежедневная сводка (cron 09:00)
/etc/hub-bots/bots.env    настройки и ключи (600)
/etc/systemd/system/hub-bots.service

Почему на узле, а не в контейнере: боты читают базы сервисов через pct exec (Navidrome, Calibre, Immich, Home Assistant) — из контейнера так нельзя.

Служба: systemctl status hub-bots, лог /var/log/hub-bots.log.

5. Где ключи

  • /etc/hub-bots/bots.env — рабочие ключи (600).
  • /root/hub-bots/ALL-SECRETS.txt — все ключи одним файлом (600).
  • ops/secrets-enc/hub-bots-secrets.age — то же, зашифровано age (в репозитории). Расшифровать: SOPS_AGE_KEY_FILE=/root/.buryan-age-key sops -d ....

6. Что дальше (по приоритету)

  1. Наполнить библиотеки — без контента боты показывают нули.
  2. Уведомления Seerr/Sonarr → комната «Медиа» (вебхук в n8n или напрямую).
  3. Frigate — как только будут камеры.
  4. Кросс-связи: книга → экранизация (Calibre ↔ Jellyfin), фото → место (Immich ↔ Home Assistant), музыка → исполнитель в медиатеке.
  5. Утренняя сводка уже включена — посмотрите комнату «Дайджесты».