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 1 month 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 (over 5 years ago)
• Default Branch: master
• Last Pushed: 2022-08-13T14:32:25.000Z (over 2 years ago)
• Last Synced: 2023-03-23T08:51:02.390Z (almost 2 years ago)
• Topics: asyncio, planning-poker, python, scrum-poker, sqlite, telegram-bot
• Language: Python
• Size: 10.7 KB
• Stars: 14
• Watchers: 2
• Forks: 7
• 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