https://github.com/russss/polybot

A framework for making social media bots for multiple networks
https://github.com/russss/polybot

bot mastodon python python3 twitter

Last synced: about 1 month ago
JSON representation

A framework for making social media bots for multiple networks

• Host: GitHub
• URL: https://github.com/russss/polybot
• Owner: russss
• License: bsd-3-clause
• Created: 2017-04-08T14:56:28.000Z (over 7 years ago)
• Default Branch: main
• Last Pushed: 2024-03-20T17:19:23.000Z (8 months ago)
• Last Synced: 2024-04-14T01:00:00.502Z (7 months ago)
• Topics: bot, mastodon, python, python3, twitter
• Language: Python
• Size: 55.7 KB
• Stars: 41
• Watchers: 4
• Forks: 10
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
[![PyPI version](https://badge.fury.io/py/polybot.svg)](https://badge.fury.io/py/polybot)

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 Twitter, Mastodon, Bluesky.

* 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

```python

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](https://twitter.com/dscovr_epic) / [@[email protected]](https://botsin.space/@dscovr_epic)

* [@dsn_status](https://twitter.com/dsn_status) / [@[email protected]](https://botsin.space/@dsn_status)

* [@[email protected]](https://botsin.space/@insight_images) (Not on Twitter)

* [Matthew's bots](https://github.com/dracos/scheduler)