Skip to main content

A Django app that integrates with Telegram to create bots.

Project description

Django Telegram App

django-telegram-app logo

A Django app to integrate Telegram bots into your project.


Style: ruff Typing: pyright Linting: pylint Framework: Django License Status: CI Validation


Documentation: https://shifqu.github.io/django-telegram-app/

Source code: https://github.com/shifqu/django-telegram-app/


Features

  • 🧩 Command-based bot architecture with step-based flow
  • 🔄 Swappable TelegramSettings model
  • ⚙️ Optional admin integration for Telegram settings
  • 📦 Extensible: add bot-commands per app via auto-discovery
  • 🛡️ Built-in system checks for misconfiguration
  • 🗄️ Django ORM integration (no direct API handling required)
  • 🧪 Easy to test (includes custom TelegramTestCase)

Requirements

  • Python 3.10+
  • Django 5.2+

Getting started

To set up your bot, follow the step-by-step guide in
➡️ Getting started

Support

See our issue tracker at: https://github.com/shifqu/django-telegram-app/issues

License

This project is licensed under the MIT License — see the LICENSE file for details.

About the Mascot

The project’s mascot is a robotic pigeon — inspired by the historical use of carrier pigeons to deliver messages reliably over long distances.
The robotic design reflects the robustness and sturdiness of the Django framework, while symbolizing automation and modern messaging flows.
Together, it represents a blend of tradition and technology: a dependable messenger for the world of Telegram bots.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

django_telegram_app-1.3.0.tar.gz (314.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

django_telegram_app-1.3.0-py3-none-any.whl (24.6 kB view details)

Uploaded Python 3

File details

Details for the file django_telegram_app-1.3.0.tar.gz.

File metadata

  • Download URL: django_telegram_app-1.3.0.tar.gz
  • Upload date:
  • Size: 314.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for django_telegram_app-1.3.0.tar.gz
Algorithm Hash digest
SHA256 200a64a7d8aa023e9c9771b388e165b1a62db7847dae920b65a137e38945aed9
MD5 f5c8f7a857866c15c5e62d4fa01aabe0
BLAKE2b-256 f063ac41c63737de2ef77a49a80fd0abd686d51cbddce6112cf65e5507c132b2

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_telegram_app-1.3.0.tar.gz:

Publisher: release.yml on shifqu/django-telegram-app

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file django_telegram_app-1.3.0-py3-none-any.whl.

File metadata

File hashes

Hashes for django_telegram_app-1.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 236ff119c91e14b3b73cb33a42f4d6f6bfb68522a989d0d26b7a95f08c1a65c9
MD5 5f2eb808d5a95fb09502e1ae5dbdb00d
BLAKE2b-256 812332579a1ac3a01f486853c25190fea7dd271bc2fe6cac00cf66830a912bfe

See more details on using hashes here.

Provenance

The following attestation bundles were made for django_telegram_app-1.3.0-py3-none-any.whl:

Publisher: release.yml on shifqu/django-telegram-app

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page