Fediverse Boost Bot 🚀

A simple and effective Python bot for automatically reposting (boosting) content to Mastodon, Akkoma, Pleroma, and other ActivityPub-based networks using selected hashtags.

📦 Version Selection (Docker Tags)

Two versions of the bot are available in our registry. Choose the one that best suits your needs:

1. :light (v1) — Minimalistic version. Performs only boosting based on a list of tags. Minimum settings, ideal for low-end servers.
2. :alpha (v2) — Advanced version. Includes a hashtag blacklist and automatically adheres to Fediverse etiquette (ignores posts with #nobot).

🛠 Quick Start (Docker Compose)

Create the docker-compose.yml file:

services:
  boost:
    image: git.vsme.cc/tr/boost:v2.1-alpha # Choose :alpha or :light
    container_name: boost
    restart: always
    environment:
      # Your server URL (required with https://)
      - MASTODON_URL=https://your.instance

      # Your access token (Settings -> Development)
      - MASTODON_TOKEN=your_token_here

      # A comma-separated list of hashtags (without the # sign)
      - HASHTAGS=art,linux,fediverse

      # Blacklist of tags (only for :v2.1-alpha)
      - FORBIDDEN_TAGS=spam,nsfw,politics

Run:

docker-compose up -d

Feature Comparison ⚙️

Feature	Light (:light)	Alpha (:v2.1-alpha)
Repost by hashtags	✅	✅
Configuration via .ENV	✅	❌
Blacklist (Forbidden Tags)	❌	✅
Ignore #nobot	❌	✅
Minimum image size	✅	⚠️

How to get a token? 🔑

1. In your instance interface, go to Settings -> Development -> New Application.
2. Enter any name and select the following scopes: read:statuses and write:statuses.
3. Save and copy the value from the "Your Access Token" field.

Local Build 🏗

If you want to build the image yourself from source:

git clone https://git.vsme.cc/tr/boost.git
cd boost
# Change to the folder of the desired version:
cd alpha # or cd light
docker build -t boost:version .

License 📜

The project is distributed under the GNU AGPLv3 license.