napcat-sdk 0.2.4

NapCat SDK for Python - Fully typed and async ready

NapCat-SDK for Python

Type-Safe • Async-Ready • Framework-Free

Stop guessing parameter types. Let the IDE do the work.

告别查文档，享受 100% 类型覆盖 带来的极致补全体验。

---

⚡ The "IDE Magic"

这就是为什么你应该选择 NapCat-SDK：

智能 API 补全 + 精准参数提示	原生开发体验 + 零心智负担

👆 真正的 140+ API 全量类型覆盖，每一次按键都有 IDE 的守护。

---

✨ Features

• 🚀 完全异步: 基于 websockets + asyncio，高并发无压力。
• 💎 强类型优先: 每一个 Event、每一个 MessageSegment 都有严格定义。
• 🔌 双模式支持: Client (正向) / Server (反向) 随意切换。
• 🛠 零依赖: 仅依赖 websockets 和 orjson，极其轻量。

---

📸 Quick Look

🖱️ 点击复制代码文本

import asyncio
from napcat.client import NapCatClient
from napcat.types import GroupMessageEvent

async def main():
    async with NapCatClient(ws_url="...", token="...") as client:
        async for event in client.events():
            match event:
                case GroupMessageEvent(raw_message="ping"):
                    await event.reply("pong!")

if __name__ == "__main__":
    asyncio.run(main())

---

📦 Installation

uv add napcat-sdk
# or
pip install napcat-sdk