:bulb: The ultimate vote and poll bot for creating, sharing and evaluating polls inside of Telegram
The project is no longer actively maintained!
Two of the most important dependencies (sqlalchemy and python-telegram-bot) released major version updates that introduced significant changes to their APIs.
I'm no longer feeling comfortable with hosting this and I don't have the time or motivation to update those dependencies. Due to this, the "official" pollbot is now offline.
This project was super useful for many people, in the end there were about ~2 million all-time users on the "official" bot instance. All good things have to come to an end though.
If you started a successful fork of this repository that has been maintained over a longer period of time, feel free to contact me. I'll then point to your fork :).
:warning: :warning: :warning: :warning: :warning: :warning: :warning: :warning: :warning: :warning: :warning: :warning: :warning:
Deciding where you and your friends are going for lunch today can be a real hassle... Or, for instance, deciding which games should be played at the next LAN-Party.
Since no other telegram poll/vote bot offered the full feature set my friends and I needed, I decided to write the ULTIMATE pollbot. A bot which combines all good features of all existing bots and even stuff beyond that.
The Ultimate Pollbot delivers a full set of well-tested and battle proven features. It's capable of handling hundreds of voters for a single poll, while offering a high customizability and a wide range of different poll types to choose from.
Here is a list of the most important features:
This bot has 6 different vote modi. Each mode is useful for various scenarios. Choose wisely.
yes
, no
and maybe
for each option.Polls can be configured to be anonymous, with the result that names of users are not visible. Polls can be made anonymous subsequently, but as soon as a poll is anonymous it stays that way forever!
Further it's possible to hide the results of the poll until it gets closed. As soon as such a poll is closed, the results will be visible. Beware!: such a poll cannot be reopened.
Thanks to Sentry for providing the project with a sponsored plan (which has super generous quotas!).
Thanks to Lokalise for providing my projects with a free license for open-source development!
Thanks to the Turkish translator:
Thanks to the Polish translator:
Thanks to all Italian translators:
Thanks to all Spanish translators:
Thanks to all Brazilian Portuguese translators:
Thanks to all German translators:
Thanks to the Catalan translator:
Thanks to the Czech translator:
/start Start the bot
/settings Open the user settings menu
/create Create a new poll
/list List all active polls and manage them
/list_closed List all closed polls and manage them
/notify Activate notifications in a external chats
/help Display the help
Dependencies:
git clone [email protected]:nukesor/ultimate-poll-bot pollbot && cd pollbot
just setup
to install all dependencies.just run
or copy the pollbot.toml
manually to ~/.config/pollbot.toml
and adjust all necessary values.
On Windows, the tilde (~
) will substitute to your home directory, usually at C:\Users\your.name\.config\pollbot.toml
.just initdb
to initialize the database (or recreate it, if necessary) and set the migration stamp to the newest alembic head.just run
.This is how you upgrade:
git pull
poetry run alembic upgrade head
to run migrations on your databasestart - Start the bot
stop - Stop the bot
delete_me - Remove me from the bot. Forever
settings - Open the user settings menu
create - Create a new poll
cancel - Cancel poll creation
list - List all active polls and manage them
list_closed - List all closed polls and manage them
notify - Activate notifications in external chats
help - Show the help text