Autofollow bot for mastodon
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Disclaimer: follow bots are viewed negatively by some instance admins and users, as their users receive a notification each time a followbot follows someone. There's already too much followbots out there for now, so unless you have very good reasons to run a single instance and a followbot, if you want one, please consider joining an instance with already one deployed. I won't provide any support in running the bot. Also, there's discussion happening on to end the need for those followbots.

The list of instances that run bots who do not implement at least #nobot will be published here soon, I'm compiling the list to integrate it into an automatic domain ban that I'll release to each instance admin.

Autofollow bot for mastodon, the first of its kind.

Simple bot that follows every new user it finds on the public timeline of an instance( except the blacklisted ones, or if the user has #nobot in his bio ).

The goal of such a bot is to help populating the federated timeline on the instance I am running with a more broad view of the fediverse. This helps also small instances federating and gathering toots on the federated timeline, ensuring that your instance is not creating a validation loop or a echo chamber.

Do not mix this kind of bot for Mastodon with bots on twitter. Follow bots on Mastodon are a way to get instances populated with users from other instances, nothing else.

It's a proof of concept, but a working one.

please keep a link to the code here or your fork, in case a user wants to be added to the blacklist.


  • ( with the pull request 24 if you want your count of followees to be accurate)

Simple script that takes care of installing dependancie in virtualenv and launching the script.

use it in cron at your own pace after the first launch ( you need to launch manually ./ first before using cron )

Example: */2 * * * * cd /home/mastodon/mastodon-autofollow; ./ >> /home/mastodon/autofollow.log


If you want to be followed by a bot, add the #followme tag in your bio !


To users: if in your bio you have the keyword #nobot, this bot won't try to follow you !

If you use this code, please respect the wishes of the person this bot will follow. Some don't want to be bothered, some instances don't want a followbot to bother them, respect them and either contact me ( ) or do a Pull Request to add your blacklist to the list. The blacklist is in, variable BLACKLIST