فریم‌ورک مدرن و سریع پایتون برای شاد.

کاملاً async، با معماری الهام‌گرفته از aiogram ۳، اتصالات مالتی‌پلکس HTTP/2 و رمزنگاری نیتیو AES-256 و RSA-1024.

شروع سریع مستندات API
pip install aioshad-py
Edge 14ms
from aioshad import Client, Router, F
from aioshad.filters import Command
from aioshad.types import Message

client = Client(session="my_bot")
router = Router()

@router.message(Command("start"))
async def on_start(msg: Message):
    await msg.reply("aioshad engine online.")

@router.message(F.text.startswith("/ask"))
async def on_question(msg: Message):
    async with client.conversation(msg.chat_id) as conv:
        await conv.send("پرسش خود را وارد کنید:")
        ans = await conv.get_response()
        await conv.send(f"دریافت شد: {ans.text}")

client.include_router(router)
client.run()
● Edge: iranlms.ir
Stream: HTTP/2
Cipher: AES-256
Ping: 14ms

نکات کلیدی معماری

  • HTTP/2 Multiplexing
  • AES-256 Native
  • aiogram 3 Style
  • Multi-Account

اتصال مستقیم به کلاسترهای لبه شاد (*.iranlms.ir) شروع سریع ←

طراحی‌شده از پایه برای مقیاس‌پذیری و پایداری

معماری الهام‌گرفته از aiogram ۳

روترهای تودرتو، فیلترهای جادویی F و ساختار کاملاً ماژولار بدون وابستگی‌های پیچیده.

from aioshad import Router, F
from aioshad.types import Message

router = Router()

@router.message(F.text == "!ping")
async def ping_cmd(msg: Message):
    await msg.reply("Pong!")

رمزنگاری معکوس‌شده نیتیو

پیاده‌سازی پرسرعت AES-256-CBC و کلیدسازی RSA-1024 بدون نیاز به مرورگر headless.

from aioshad.crypto import encrypt_payload

# Direct edge payload encryption
enc = encrypt_payload(data, aes_key)

انواع ذخیره‌ساز سشن

پشتیبانی از FileSession، پایگاه‌داده ACID SQLite و MemorySession برای استقرار ابری.

from aioshad.session import SQLiteSessionStorage

storage = SQLiteSessionStorage("bot.db")
client = Client(session=storage)

چندین اکانت همزمان

ارکستراسیون و اجرای موازی ده‌ها اکانت و سلف‌بات با شیء ClientManager در یک حلقه رخداد.

manager = ClientManager()
manager.add_client(bot_support)
manager.add_client(bot_sales)
await manager.start_all()

ویس چت گروهی WebRTC

ایجاد نشست صوتی گروهی، کنترل وضعیت میکروفون و تعامل مستقیم در اتاق‌های گفتگو.

await client.create_voice_chat(gid)
await client.change_voice_chat_voice_status(
    gid, vc_id, status="speaking"
)

مکالمات خطی و ماشین وضعیت (FSM)

ایجاد پرسش‌نامه‌ها و فرم‌های تعاملی مرحله‌به‌مرحله با کانتکست منیجر گفت‌وگو و FSMContext.

async with client.conversation(chat_id, timeout=60) as conv:
    await conv.send("نام شما چیست؟")
    name = await conv.get_response()
    await conv.send(f"خوشبختم {name.text}!")

کدهای تمیز و الگوهای آماده

from aioshad import Router, F
from aioshad.filters import Command, CommandObject
from aioshad.types import Message

router = Router()

@router.message(Command("calc"))
async def calc_handler(msg: Message, command: CommandObject):
    expression = command.args
    await msg.reply(f"Result: {eval(expression)}")

@router.message(F.text.startswith("info"))
async def info_handler(msg: Message):
    await msg.reply(f"Chat ID: {msg.chat_id}
Author: {msg.author_guid}")