finds.dev

ohld/django-telegram-bot

My sexy Django + python-telegram-bot + Celery + Redis + Postgres + Dokku + GitHub Actions template

View on GitHubHomepage ↗

★ 719PythonApache-2.0updated Apr 2024

// 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 →

// at a glance

Stars
719
Forks
168
Language
Python
License
Apache-2.0
Last commit
17 Apr 2024

// nearby

If django-telegram-bot isn't quite it.

All repos →