Ariadne

用 Python 优雅开发 QQ 机器人，快速实现自动化交互

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署对话助手 🍴 复刻 44 🐛 待处理 7 👀 关注 5

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 761

维护状态维护中

是否开源开源

定价模式 🏷️完全免费开源框架，基于AGPL-3.0许可证，完全免费，无付费版本。

项目预览

项目数据

分类对话助手

开发团队GraiaProject

官网地址https://graia.cn/ariadne

GitHubhttps://github.com/GraiaProject/Ariadne

定价模式🏷️完全免费

价格说明开源框架，基于AGPL-3.0许可证，完全免费，无付费版本。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议AGPL-3.0

主要语言Python

技术栈/模型ariadne,asyncio,automation,bot,chatbot,framework,graia,graiaproject,mirai,mirai-api-http,python,qq,qqbot

GitHub 星标★ 761

上线时间2021-10-16 00:00:00

代码更新2026-10-05

仓库体积3.6 MB

本站数据更新2026-11-10

维护状态维护中

收录时间2026-08-09

浏览次数4

项目介绍

Ariadne 是 Graia Project 旗下的 Python QQ 自动化框架，基于 Mirai API HTTP v2 实现。它旨在为开发者提供一套优雅、完备且异步的 QQ 机器人开发工具，解决从底层协议交互到上层业务逻辑编排的完整问题。其核心能力包括：提供类型安全的 API 封装，减少手写 HTTP 请求和 JSON 解析的繁琐；内置事件系统，支持多种 QQ 事件（如消息、群成员变动等）的监听与分发；支持插件化架构，方便模块化开发；与 Graia 生态（如 Graia Scheduler、Graia Broadcast）无缝集成，可快速构建定时任务、复杂交互等场景。Ariadne 强调代码的可读性与可维护性，通过装饰器和依赖注入简化开发流程，让开发者专注于业务逻辑而非协议细节。项目目前处于早期阶段，但已具备生产可用的基础能力。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 761

技术标签

asyncio automation bot chatbot framework

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：进阶约 25 分钟部署方式：本地安装 4 步

环境要求

Python 3.9+
mirai-api-http v2
一个 QQ 账号

安装与启动步骤

1装

适配 mirai-api-http v2 的 Python 机器人框架。
```
pip install graia-ariadne
```
2起 mirai

先跑 mirai-api-http，拿到地址与 verifyKey。
```
配置 mirai-api-http 的 adapter 与端口
```
3写最小 bot

订阅消息事件并回复。
```
from graia.ariadne.app import Ariadne
```
4跑起来

日志里应看到已连接。
```
python bot.py
```