sent 1.0.0

Async MTProto client library for Telegram user accounts and bots

sent

sent is an async MTProto client library for Telegram. It speaks the raw Telegram protocol and supports both user accounts and bots with an event-driven, developer-friendly API.

Features

• Async MTProto 2.0 — encryption, sessions, RPC with RpcResult / MsgContainer handling
• User accounts and bots — phone + code login, SRP 2FA, bot token, QR login
• Event system — NewMessage, MessageDeleted, MessageRead, CallbackQuery, ChatAction, UserUpdate, Album
• Friendly API — send_message, send_file, get_dialogs, iter_messages, conversation()
• TL layer 225 — auto-generated from the latest Telegram schema
• Session storage — SQLite (with entity cache), StringSession, or in-memory
• Transport — TCP abridged / intermediate / full, SOCKS5 proxy support

Installation

pip install sent

Optional extras for faster cryptography:

pip install sent[fast]    # cryptg (recommended for production)
pip install sent[crypto]  # pycryptodome fallback

For local development:

git clone https://github.com/kalanakt/sent.git
cd sent
uv sync --all-extras

Quick start

Get your api_id and api_hash from my.telegram.org.

Bot

import asyncio
import os

from sent import TelegramClient, events

API_ID = int(os.environ["TELEGRAM_API_ID"])
API_HASH = os.environ["TELEGRAM_API_HASH"]
BOT_TOKEN = os.environ["TELEGRAM_BOT_TOKEN"]


async def main():
    client = TelegramClient("echo_bot", API_ID, API_HASH)

    @client.on(events.NewMessage)
    async def handler(event):
        await event.reply(event.text)

    await client.start(bot_token=BOT_TOKEN)
    await client.run_until_disconnected()


asyncio.run(main())

See examples/echo_bot.py for a complete echo bot.

User account

import asyncio
import os

from sent import TelegramClient, events

API_ID = int(os.environ["TELEGRAM_API_ID"])
API_HASH = os.environ["TELEGRAM_API_HASH"]


async def main():
    client = TelegramClient("my_account", API_ID, API_HASH)

    @client.on(events.NewMessage(incoming=True))
    async def handler(event):
        await event.reply("Hello!")

    await client.start()  # prompts for phone, code, and 2FA when needed
    me = await client.get_me()
    print(f"Logged in as {me.first_name}")
    await client.run_until_disconnected()


asyncio.run(main())

See examples/user_bot.py for a fuller user-account example.

Conversation helper

async with client.conversation("username") as conv:
    await conv.send_message("What's your name?")
    response = await conv.get_response()
    print(response.text)

Development

uv sync --group test
uv run pytest test/ -v

Run benchmarks:

uv run python bench/run.py

Regenerate TL types after updating the schema:

python -m sent._codegen.generate

See CONTRIBUTING.md for full contributor and release guidelines.

Project links

• Source: https://github.com/kalanakt/sent
• Issues: https://github.com/kalanakt/sent/issues
• PyPI: https://pypi.org/project/sent/

License

MIT — see LICENSE.