Skip to content

Installation

telegram-webapp-auth supports Python 3.10 and newer. It has one runtime dependency: cryptography, which is used for Telegram's Ed25519 third-party validation flow.

Requirements

  • Python 3.10+
  • A Telegram bot token for the standard Mini App backend flow
  • A Telegram bot ID for third-party validation

Keep bot tokens on the backend

Never send your bot token to a browser, Mini App frontend, mobile client, log stream, or analytics tool. Use the token only on trusted backend infrastructure.

Install The Package

python -m pip install --upgrade telegram-webapp-auth

poetry add telegram-webapp-auth

uv add telegram-webapp-auth

Create A Clean Environment

For a new project, use a virtual environment before installing dependencies:

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install telegram-webapp-auth

On Windows PowerShell, activate the environment with:

.venv\Scripts\Activate.ps1

Verify The Installation

from telegram_webapp_auth.auth import TelegramAuthenticator
from telegram_webapp_auth.auth import generate_secret_key

secret_key = generate_secret_key("123456:ABC-DEF")
authenticator = TelegramAuthenticator(secret_key)

The package is ready when this snippet imports and creates an authenticator without errors.

Next Steps