A chatbot with configurable plugins to use in Telegram channels
Find a file
2020-12-14 23:26:06 +01:00
.github/workflows Coverage for the plugins package as well 2020-12-14 23:26:06 +01:00
assets What is my purpose? 2020-04-23 11:00:19 +02:00
butterrobot Some documentation 2020-12-14 23:25:48 +01:00
butterrobot_plugins_contrib Black everything 2020-12-13 08:46:09 +01:00
docker Admin interface for channels and plugins 2020-12-08 20:17:19 +01:00
docs Documentation 2020-12-13 08:28:08 +01:00
tests Some documentation 2020-12-14 23:25:48 +01:00
.env-example What is my purpose? 2020-04-23 11:00:19 +02:00
.gitignore Ignore .coverage file 2020-12-11 21:37:17 +01:00
Dockerfile.dev Admin interface for channels and plugins 2020-12-08 20:17:19 +01:00
Makefile Coverage for the plugins package as well 2020-12-14 23:26:06 +01:00
poetry.lock Added database tests along with workflows 2020-12-11 17:33:56 +01:00
pyproject.toml Added database tests along with workflows 2020-12-11 17:33:56 +01:00
README.md Documentation 2020-12-13 08:28:08 +01:00
setup.cfg What is my purpose? 2020-04-23 11:00:19 +02:00

Butter Robot

Stable Master
Build stable tag docker image Build latest tag docker image
Pytest Pytest

Python framework to create bots for several platforms.

Butter Robot

What is my purpose?

Documentation

Go to documentation

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/butterrobot container image is published on Github packages to use with your favourite tool:

docker pull docker.pkg.github.com/fmartingr/butterrobot/butterrobot:latest
podman run -d --name fmartingr/butterrobot/butterrobot -p 8080:8080

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

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