Wonda 🍄

Wonda is a Telegram bot framework. It's light, blazing fast and feature rich. It also supports latest Bot API versions immediately. Join our Telegram forum by clicking the mushroom up top!

Install

pip install wonda

A stable version of Wonda can be installed using this command. Add --pre to the command to install a pre-release version.

Features

You can build a basic bot in only 6 lines of code:

from wonda import Bot, Message

bot = Bot("your-token")

@bot.on.message()
async def handler(m: Message) -> None:
    await m.answer("Hello world!")

bot.run_forever()

You can also format text, upload files, translate your bot to dozens of languages and make use of an advanced state system to build complex interactions. To learn more, check out the examples.

Customization

Wonda ships with few dependencies by default. To customize your experience, you may want to install some extra dependencies on top.

Speed up event loop

pip install uvloop

Wonda supports uvloop, an event loop implementation which makes I/O 2-4x quicker.

Replace default JSON module

pip install orjson

Swap out the module that is used under the hood to manipulate JSON and increase speed up to 5 times.

Display tracebacks in greater detail

pip install rich

Check out rich, a library which provides amazing rich text capabilities for your logs.

Contrubuting

This framework is a robust solution for what it's worth, but the API may be unstable for a while. That means it's not yet ready for production use.

So, if you like our work, help us develop this amazing project! Here are some ways you can help.

With code

Contributions are welcome! File a ticket if you have something to say about the state of the framework.

With finances

There are a couple options available for monetary help. Click Sponsor to see them. Thank you!

License

This project exists thanks to the amazing work done by timoniq. Code is licensed under MIT.