Metadata-Version: 2.4
Name: botiksdk
Version: 0.5.0
Summary: Python SDK for Vontic Bot Platform — full aiogram-style API with WebSocket support
Author-email: Vondic <support@vondic.com>
License: MIT
Project-URL: Homepage, https://github.com/vondic/vondic/tree/main/botiksdk
Project-URL: Bug Tracker, https://github.com/vondic/vondic/issues
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Development Status :: 4 - Beta
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: Topic :: Communications :: Chat
Requires-Python: >=3.9
Description-Content-Type: text/markdown
Requires-Dist: requests>=2.32.5
Requires-Dist: websocket-client>=1.6.0
Dynamic: requires-python

# BotikSDK

Python SDK для создания ботов на платформе Vontic. Полный функционал aiogram 3.x через Vontic API.

## Установка

```bash
pip install botiksdk
```

## Быстрый старт

```python
import os
from botiksdk import Bot, Dispatcher, Message, Command

bot = Bot(bot_id=os.getenv("BOT_ID"), token=os.getenv("BOT_TOKEN"))
dp = Dispatcher()
dp.include_bot(bot)

@dp.message(Command("start"))
async def start(message: Message, bot: Bot):
    await bot.send_message(str(message.chat.id), "Привет!")

dp.run_polling()
```

## Возможности

- **Команды и фильтры** — Command, Text, Regex, F, RateLimit, RequireScopes
- **Клавиатуры** — ReplyKeyboardBuilder, InlineKeyboardBuilder
- **Медиа** — photo, video, audio, voice, document, sticker, InputMedia (альбомы)
- **15+ типов сообщений** — text, photo, video, voice, poll, location, contact, dice...
- **Модерация** — ban, kick, restrict, promote, delete_message
- **Опросы** — send_poll, stop_poll
- **Consent permissions** — RequireScopes, check_permissions
- **FSM** — конечные автоматы для диалогов
- **Middleware** — pre/post обработка сообщений
- **Error handlers** — глобальная обработка ошибок
- **Startup/Shutdown** — хуки при запуске/остановке
- **Webhook** — set_webhook, delete_webhook
- **70+ методов Bot API**

## Документация

Подробная документация с примерами кода на русском: https://vondic.ru/api-docs

## Лицензия

MIT
