selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Codeberg

Self-host hypebot

Mastodon bot that boosts trends from other instances

BetaOpen SourceAGPL-3.0-or-later
Updated7 months ago
Setup difficultyEasy
Docker
t4nte/hype
Install with Docker Compose

What is hypebot?

hypebot is a self-hosted Mastodon bot that fetches trending posts from other instances and boosts them into your server's timeline. It is aimed at operators of smaller Fediverse instances where the local timeline tends to be sparse, helping improve discoverability of accounts and topics across the federated social web. You configure which instances to follow and how many trending posts per instance to boost, set a refresh interval, define blocklists to filter undesired sources, exclude specific accounts, and optionally require alt-text on image posts before boosting. The bot also respects the #nobot or #nobots hashtag in user profiles. Running it requires deploying the t4nte/hype container via Docker Compose, creating a Mastodon application token on your bot account, and supplying an auth.yaml for credentials plus a config.yaml for tuning. It is a Python application forked from Valentin Reiss' original hype project.

hypebot alternatives

Should you self-host hypebot?

hypebot scores 50/100 on selfhost.directory (how scoring works) and ranks #51 of 75 in Social Networks & Forums.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is easy: most people get it running in one sitting. An official Docker image is available. It is AGPL-3.0-or-later-licensed.

Its closest alternative on selfhost.directory is Mastodon (84/100, 50 616 stars). It scores higher overall, so compare the two before you pick. See hypebot vs Mastodon side by side.

Features

  • Account exclusion
  • Alt-text enforcement
  • Boost trending posts from other instances
  • Configurable refresh interval
  • Instance blocklists
  • Nobot hashtag support
  • Per-instance post limits

How to install hypebot

Install hypebot with Docker Compose

version: "3"
services:
  hype:
    image: t4nte/hype:latest
    volumes:
      - ./config:/app/config

Create config.yaml and auth.yaml in ./config/ before running

How to configure hypebot

  • interval60Refresh interval in minutes between fetching trending posts
  • profile_prefixText to add to the bot profile before the list of subscribed servers
  • blocklist_urlsURLs of blocklists to add to the instance
  • require_alt_texttrueWhether to skip posts with images that lack alt text
  • subscribed_instancesInstances to follow with a per-instance limit for top trending posts (API max 20)

More in Social Networks & Forums

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…