telegrinder

— effective and reliable telegram bot building.

• Type hinted
• Customizable and extensible
• Ready to use scenarios and rules
• Fast models built on msgspec
• Both low-level and high-level API
• Support for different dependency builds

Basic example:

from telegrinder import API, Message, Telegrinder, Token
from telegrinder.modules import logger
from telegrinder.rules import Text

logger.set_level("INFO")
api = API(token=Token("123:token"))
bot = Telegrinder(api)


@bot.on.message(Text("/start"))
async def start(message: Message) -> None:
    me = (await api.get_me()).unwrap()
    await message.answer(f"Hello, {message.from_user.full_name}! I'm {me.full_name}.")


bot.run_forever()

Getting started

Install using pip, uv or poetry:

pip install telegrinder
poetry add telegrinder
uv add telegrinder

Or install from source (unstable):

pip install git+https://github.com/timoniq/telegrinder/archive/dev.zip
uv add "telegrinder @ git+https://github.com/timoniq/telegrinder.git@dev"
poetry add git+https://github.com/timoniq/telegrinder.git#dev

Documentation

Readthedocs

Community

Join our telegram forum.

License

Telegrinder is MIT licensed
Copyright © 2022-2025 timoniq
Copyright © 2024-2025 luwqz1

Contributors

How to contribute