GoyGram

GoyGram is an asynchronous Python framework for Telegram. It supports CPython 3.13 and newer, with schema-generated IDE autocomplete for the dynamic Bot API and MTProto method surface.

It can run a bot or connect to Telegram as a user account. Pick the one you need:

• Bot API — use this for a normal Telegram bot created with BotFather.
• MTProto — use this when your program must work as your Telegram account.

Start here

• Installation
• Build a bot
• Connect a user account

Next steps

• Write handlers
• Choose which messages to handle
• Add buttons and state
• Send files and photos

When you need the details

• Client reference
• Sugar API: formatting, media sends, new filters
• Rich messages: in-message buttons, blocks, html entities
• Event objects
• Bot API calls
• MTProto calls
• Sessions and authentication
• FAQ

The GitHub repository contains the source code and issue tracker. Keep bot tokens, API credentials, session files, and vault files private.