// the take
A batteries-included Django template for building Telegram bots: python-telegram-bot for the Telegram side, Celery/Redis for background jobs, Postgres/SQLite for storage, and Dokku + GitHub Actions for deployment. Aimed at someone who wants a bot with an admin panel and broadcast/export tooling without assembling that stack themselves.
The stack is actually wired together end to end, not just listed as dependencies — polling and webhook modes both work, Celery is hooked up for background and periodic jobs, and the Django admin panel gives you user management for free. The built-in commands (/broadcast, /export_users, /stats, location capture with reverse geocoding) are the stuff most people end up building themselves for any bot with real users. Handlers are split by feature (onboarding, broadcast_message, location) instead of one sprawling bot.py, so it's easy to find where to add your own.
Last push was April 2024 — python-telegram-bot has moved through major API changes since (the async rewrite in v20+), so there's real risk this template is pinned to an older PTB version whose patterns don't match current docs. The webhook setup relies on a secret URL path rather than Telegram's built-in secret_token header verification, which is a weak way to authenticate incoming webhook calls in production. Dokku deployment is explicitly single-server per the README's own caveat — there's no real horizontal scaling story, so growth past one box means a deployment rewrite, not a config change. No visible test suite, which matters more here than in most templates since you're meant to build directly on top of the broadcast/admin code paths it ships.
We read the README, the directory tree and a key source file in November 2026. Nobody pays to be listed. How we judge →