Wonda 🍄

Wonda is a Telegram bot framework. It strikes a perfect balance between simple and advanced and makes bot development a breeze. Its concepts are easy to understand and extend. And, with immediate support for latest Bot API versions, it always stays up to the standard.

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

Ever wanted to build a bot? You can do that 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 already format text, upload files, and make use of an advanced state system to build complex interactions. More features are expected to come! 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. Copyright (c) 2022-2024 kikimaradoni