AioScam Documentation¶
Async Python framework for Max messenger bots
Installation¶
pip install aioscam
Quick Start¶
from aioscam import Bot, Dispatcher, Router
from aioscam.filters import Command
dp = Dispatcher()
router = Router()
@router.message_created(Command("start"))
async def cmd_start(event):
await event.answer("Привет!")
dp.include_router(router)
async def main():
bot = Bot() # token from MAX_BOT_TOKEN env var
await dp.start_polling(bot)
Features¶
🚀 Fully async - Built on asyncio and aiohttp
🎯 aiogram-style API - Familiar decorators and patterns
🔄 Router system - Modular bot architecture
🎭 Magic Filters - Declarative event filtering
📦 FSM - Finite state machine with MemoryStorage
🛡️ StateGuard - Blocks unauthorized commands during FSM states
🌐 Webhook support - aiohttp, FastAPI, Litestar
📡 Polling mode - Long-polling with exponential backoff
Contents¶
English
- AioScam — Documentation (EN)
- Table of Contents
- Installation
- Quick Start
- Architecture
- Bot Methods
- Media
- Dispatcher & Router
- EventContext
- Filters
- FSM
- Middleware
- Keyboards
- Deep Links
- I18n
- Rate Limiter
- Webhook
- WebApp (Mini Apps)
- BotCapabilities
- ChatRegistry
- Polls & Quizzes (PollManager)
- Max API v2 migration & certificates
- Exceptions & Hints
- Configuration
- License
Русский
- AioScam — Документация (RU)
- Оглавление
- Установка
- Быстрый старт
- Архитектура
- Bot
- Медиафайлы
- Dispatcher и Router
- EventContext
- Фильтры
- FSM
- Middleware
- Клавиатуры
- Deep links
- I18n
- Rate Limiter
- Webhook
- WebApp (мини-приложения)
- BotCapabilities
- ChatRegistry — реестр чатов
- Опросы и квизы (PollManager)
- Миграция Max API v2 и сертификаты
- Исключения и hint
- Конфигурация
- Лицензия