Metadata-Version: 2.5
Name: baleon
Version: 0.0.1
Summary: Simple, async-first Python framework for building Bale bots
Project-URL: Homepage, https://github.com/yardankasa/baleon
Project-URL: Repository, https://github.com/yardankasa/baleon
Project-URL: Issues, https://github.com/yardankasa/baleon/issues
Project-URL: Documentation, https://docs.bale.ai/
Author: Mahdi
License-Expression: MIT
License-File: LICENSE
Keywords: async,bale,bot,framework,messenger
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Communications :: Chat
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx<1.0.0,>=0.27.0
Provides-Extra: dev
Requires-Dist: pytest-asyncio>=0.24.0; extra == 'dev'
Requires-Dist: pytest>=8.0.0; extra == 'dev'
Requires-Dist: respx>=0.21.0; extra == 'dev'
Description-Content-Type: text/markdown

# baleon

Simple, async-first Python framework for building [Bale](https://bale.ai) bots.

## Install

```bash
pip install baleon
```

For local development:

```bash
pip install -e ".[dev]"
```

## Quick start

```python
from baleon import Bot

bot = Bot("TOKEN")

@bot.api.command("start")
async def start(message):
    await message.reply("Welcome to baleon")

@bot.api.on_message()
async def echo(message):
    if message.text:
        await message.reply(message.text)

bot.run()
```

Create a bot token with [@botfather](https://ble.ir/botfather) in Bale, then replace `TOKEN`.

## Features (MVP)

- Async-first API over `https://tapi.bale.ai`
- Unified `bot.api` for handlers and Bot API methods
- Long polling via `bot.run()`
- Commands, messages, and callback queries
- Reply helpers on `Message` and `CallbackQuery`

## Docs

Official Bale Bot API: https://docs.bale.ai/

## License

MIT
