Fediverse Boost Bot 🚀

Простой и эффективный бот на Python для автоматического репоста (буста) контента в Mastodon, Akkoma, Pleroma и других сетях на базе ActivityPub по выбранным хештегам.

📦 Выбор версии (Docker Tags)

В нашем реестре доступны две версии бота. Выберите ту, которая подходит под ваши задачи:

1. :light (v1) — Минималистичная версия. Выполняет только буст по списку тегов. Минимум настроек, идеально для слабых серверов.
2. :alpha (v2) — Продвинутая версия. Включает «черный список» хештегов и автоматически соблюдает этику Fediverse (игнорирует посты с #nobot).

🛠 Быстрый старт (Docker Compose)

Создайте файл docker-compose.yml:

services:
  fedi-boost:
    image: git.vsme.cc/tr/fedi-boost:alpha # Выберите :alpha или :light
    container_name: fedi-boost
    restart: always
    environment:
      # URL вашего сервера (обязательно с https://)
      - MASTODON_URL=https://ваш.инстанс
      
      # Ваш токен доступа (Настройки -> Разработка)
      - MASTODON_TOKEN=ваш_токен_здесь
      
      # Список хештегов через запятую (без знака #)
      - HASHTAGS=art,linux,fediverse
      
      # Черный список тегов (только для версии :alpha)
      - FORBIDDEN_TAGS=spam,nsfw,politics 

Запуск:

docker-compose up -d 

Сравнение возможностей ⚙️

Функция	Light (:light)	Alpha (:alpha)
Репост по хештегам	✅	✅
Настройка через ENV	✅	✅
Черный список (Forbidden Tags)	❌	✅
Игнорирование #nobot / #noAtom	❌	✅
Минимальный вес образа	✅	⚠️

Как получить токен? 🔑

1. В интерфейсе вашего инстанса откройте Настройки -> Разработка -> Новое приложение.
2. Укажите любое имя и выберите права (Scopes): read:statuses и write:statuses.
3. Сохраните и скопируйте значение из поля Ваш токен доступа.

Локальная сборка 🏗

Если вы хотите собрать образ самостоятельно из исходного кода:

git clone https://git.vsme.cc/tr/fedi-boost.git
cd fedi-boost
# Перейдите в папку нужной версии:
cd v2-alpha # или cd v1-light
docker build -t fedi-boost: version .

Лицензия 📜

Проект распространяется под лицензией MIT.