# hypebot

> Self-hosted open-source Mastodon bot that boosts trending posts from configured instances into your local timeline, aiding discovery on smaller Fediverse servers.

- **Category:** [Social Networks & Forums](https://selfhost.directory/social-networks-forums)
- **Licence:** AGPL-3.0-or-later
- **Source model:** Open source
- **Author:** tante
- **Platforms:** Docker Compose
- **Tags:** Social Media, Mastodon, Bot, Activitypub, Federation, Fediverse

## Docker images

- [`t4nte/hype`](https://hub.docker.com/r/t4nte/hype)

## 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.

## Should you self-host hypebot?

hypebot scores **50/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#51 of 75** in [Social Networks & Forums](https://selfhost.directory/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](https://selfhost.directory/project/mastodon) (84/100, 50 557 stars). It scores higher overall, so compare the two before you pick. [See hypebot vs Mastodon side by side.](https://selfhost.directory/compare/hypebot-vs-mastodon)

## 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

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

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

## hypebot alternatives

- [Mastodon](https://selfhost.directory/project/mastodon): Open-source self-hosted microblogging server that federates over ActivityPub, with chronological timelines, media posts, moderation tools and an OAuth2 REST API. (compare: https://selfhost.directory/compare/hypebot-vs-mastodon)
- [social-auto-engine](https://selfhost.directory/project/social-auto-engine): Self-hosted open-source social media manager with AI content generation. Supports 5 platforms with mandatory human approval queue. Includes MCP server and 17 AI skills. (compare: https://selfhost.directory/compare/hypebot-vs-social-auto-engine)
- [Phanpy](https://selfhost.directory/project/phanpy): Phanpy is a self-hosted, open-source Mastodon web client with a minimalistic design, multi-account support, nested threads, and multi-column layouts. (compare: https://selfhost.directory/compare/hypebot-vs-phanpy)
- [discord-rss-bot](https://selfhost.directory/project/discord-rss-bot): Self-hosted Discord bot that monitors RSS feeds and posts updates to channels in real-time with configurable intervals and Docker support. (compare: https://selfhost.directory/compare/discord-rss-bot-vs-hypebot)
- [Takahē](https://selfhost.directory/project/takahe): Self-hosted open-source ActivityPub server for microblogging with multi-domain and multi-identity support, Mastodon API compatible. (compare: https://selfhost.directory/compare/hypebot-vs-takahe)
- [Hollo](https://selfhost.directory/project/hollo): Hollo is a self-hosted, open-source ActivityPub microblogging server for single users that implements the Mastodon API so you can use any compatible client. (compare: https://selfhost.directory/compare/hollo-vs-hypebot)
- [Glitch-Soc](https://selfhost.directory/project/glitch-soc): Mastodon Glitch Edition is a self-hosted, open-source ActivityPub microblogging server adding experimental features like Markdown posts and advanced theming to Mastodon. (compare: https://selfhost.directory/compare/glitch-soc-vs-hypebot)
- [hometown](https://selfhost.directory/project/hometown): Hometown is a self-hosted social network server for private communities: local-only posts don't federate, articles from Write.as render in feeds. (compare: https://selfhost.directory/compare/hometown-vs-hypebot)

## More in Social Networks & Forums

- [Iceshrimp.NET](https://selfhost.directory/project/iceshrimpnet): Iceshrimp.NET is a decentralized and federated social networking service implementing the ActivityPub standard, with a focus on performance, stability, and maintainability.
- [idno](https://selfhost.directory/project/idno): Idno is a self-hosted, open-source social publishing platform for the fediverse via ActivityPub, Webmentions, and IndieWeb. Runs on PHP with MySQL or MongoDB.
- [Inventaire](https://selfhost.directory/project/inventaire): Open-source, self-hosted webapp for collaborative book inventories and lending among friends and groups, built on a bibliographic database mapped to Wikidata and ISBNs.
- [Kbin](https://selfhost.directory/project/kbin): /kbin is a self-hosted, open-source content aggregator and microblogging platform federating via ActivityPub. Offers Reddit-like magazines, moderation, REST/GraphQL APIs.
- [Kittygram](https://selfhost.directory/project/kittygram): Self-hosted, open-source Instagram browsing proxy in the spirit of Nitter, with themes, Valkey caching and optional Atom feeds.
- [Known](https://selfhost.directory/project/known): Idno is a self-hosted, open-source social publishing platform for personal blogs. It supports ActivityPub federation, Webmentions, Microformats2, and RSS feeds.
- [Ktistec](https://selfhost.directory/project/ktistec): Ktistec is a self-hosted, open-source ActivityPub server for individuals and small groups, written in Crystal with SQLite storage and a rich web UI.
- [Lemmy](https://selfhost.directory/project/lemmy): Self-hosted, open-source fediverse link aggregator and forum: federated communities, upvotes, threaded comments, mod logs. Built in Rust, deployed via Docker or Ansible.
- [Libervia](https://selfhost.directory/project/libervia): Libervia-web is a web-based interface for Libervia, a decentralized and federated communication platform based on XMPP. It provides features such as instant messaging, microblogging, file sharing, photo albums, events, and forums.
- [Libreddit](https://selfhost.directory/project/libreddit): Self-hosted, open-source private front-end for Reddit written in Rust that proxied all traffic server-side; it stopped working in 2023 and lives on as the Redlib fork.
- [lobsters-rails-project](https://selfhost.directory/project/lobsters-rails-project): Open-source, self-hosted Rails app for running your own link-aggregation and discussion community, with tags, invitations, and public moderation logs.
- [Loomfeed](https://selfhost.directory/project/loomfeed): Loomfeed is a self-hosted, open-source Reddit alternative where AI agents participate as first-class citizens with provenance tracking and epistemic status labels.

## Links

- [Homepage](https://codeberg.org/tante/hypebot)

---
Source: https://selfhost.directory/project/hypebot