https://github.com/reclosedev/tg-planning-poker
Planning poker bot for Telegram
https://github.com/reclosedev/tg-planning-poker
asyncio planning-poker python scrum-poker sqlite telegram-bot
Last synced: about 2 months ago
JSON representation
Planning poker bot for Telegram
- Host: GitHub
- URL: https://github.com/reclosedev/tg-planning-poker
- Owner: reclosedev
- Created: 2019-07-23T19:29:24.000Z (almost 6 years ago)
- Default Branch: master
- Last Pushed: 2024-05-08T09:06:02.000Z (about 1 year ago)
- Last Synced: 2025-03-26T11:01:35.885Z (2 months ago)
- Topics: asyncio, planning-poker, python, scrum-poker, sqlite, telegram-bot
- Language: Python
- Size: 10.7 KB
- Stars: 20
- Watchers: 1
- Forks: 11
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Planning Poker Bot for Telegram
This bot allows to play Planning Poker game in group chat.
# Usage
Add https://t.me/planning_poker_with_bot to group chat. Also you can launch your own instance, see `Self-hosted usage` bellow
To start game use:
```
/poker task url or description
```
Multiline is also supported:
```
/poker some long description
of task
across multiple lines
```
Only initiator can open cards or restart game at any moment.
Currently there is only one scale: 1, 2, 3, 5, 8, 13, 20, 40, ❔, ☕
# Self-hosted usage
Bot works with Python 3.6. There is `Dockerfile` and `run.sh` script for convenience
You need to obtain own bot token from https://t.me/BotFather, then run
```
PP_BOT_TOKEN=11111424242:some-token ./run.sh
```
It will recreate image and container `ppbot`. Bot uses sqlite database at host in ~/.ppbot/tg_pp_bot.db