telegrinder 0.5.1

Modern visionary telegram bot framework.

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

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:

uv add telegrinder
poetry add telegrinder
pip install telegrinder

Or install from source (unstable):

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

Documentation

Tutorial

Community

Join our telegram forum.

License

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

Contributors

How to contribute