Skip to main content

What is my purpose?

Project description

Butter Robot

Docker Repository on Quay

Python framework to create bots for several platforms.

Butter Robot

What is my purpose?

Supported platforms

Name Receive messages Send messages
Slack (app) Yes Yes
Slack (webhook) Planned No[^1]
Telegram Yes Yes

[^1]: Slack webhooks only supports answering to incoming event, not sending messages on demand.

Provided plugins

Butter robot

  • Help
  • Usage
  • Changelog

Development

  • Ping

Fun and entertainment

  • Dice roll
  • Loquito

Installation

PyPi

You can run it directly by installing the package and calling it with python though this is not recommended and only intended for development purposes.

$ pip install --user butterrobot
$ python -m butterrobot

Containers

The fmartingr/butterrobot container image is published on quay.io to use with your favourite tool:

podman run -d --name butterrobot -p 8080:8080 quay.io/fmartingr/butterrobot

Contributing

To run the project locally you will need poetry.

git clone git@github.com:fmartingr/butterrobot.git
cd butterrobot
poetry install

Create a .env-local file with the required environment variables, you have an example file.

SLACK_TOKEN=xxx
TELEGRAM_TOKEN=xxx
...

And then you can run it directly with poetry

TODO: Autoload .env-local

docker run -it --rm --env-file .env-local -p 5000:5000 -v $PWD/butterrobot:/etc/app/butterrobot local/butterrobot python -m butterrobot

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

butterrobot-0.0.2a1.tar.gz (7.5 kB view hashes)

Uploaded Source

Built Distribution

butterrobot-0.0.2a1-py3-none-any.whl (11.6 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page