russss/polybot repository overview

Polybot is a framework for making social media bots for multiple networks in Python 3.

It currently only supports post-only bots.

⁠Features

• Automatically post to both Twitter and Mastodon.
• A friendly setup interface to handle the OAuth hassle for you.
• Automatic state persistence - just put your state in the self.state dict and it'll get saved/restored across runs.

⁠Example

from polybot import Bot

class HelloWorldBot(Bot):
  def main(self):
    self.post("Hello World")

HelloWorldBot('helloworldbot').run()

To configure the accounts the bot uses, just run:

./helloworldbot.py --setup

You'll be guided through authenticating and a config file will be automatically created.

Use the --profile [name] to save and use a specific state/config.

By default, the bot will run in development mode, which avoids actually posting to networks. To run in live mode, pass the --live flag.

⁠Bots which use polybot

• @dscovr_epic⁠ / @[email protected]⁠
• @dsn_status⁠ / @[email protected]⁠
• @[email protected]⁠ (Not on Twitter)
• Matthew's bots⁠