GraiaProject / Application

一个设计精巧, 协议实现完备的, 基于 mirai-api-http 的即时聊天软件自动化框架.
https://graia-document.vercel.app/
GNU Affero General Public License v3.0
438 stars 63 forks source link
framework python qq qqbot qqrobot

此仓库已废弃, 请使用替代品 Ariadne; 本项目被标记为 v4, 相对的有 v4+(Ariadne) 与 v5(WIP, 尚未完工), 目前我推荐使用 Ariadne.

Graia Application for mirai-api-http

当前最新版本: PyPI
所需求的最低 CPython 版本: PyPI - Python Version
已确认可以在其上运行的 Python 实现: PyPI - Implementation

开始使用

文档地址: https://graia-document.vercel.app/
API 文档地址(使用 pdoc 生成): https://graiaproject.github.io/Application/graia/application/index.html

Tencent QQ 交流群: 邀请链接
Discussion: https://github.com/GraiaProject/Application/discussions

从 Pypi 安装

pip install graia-application-mirai
# 或使用 poetry
poetry add graia-application-mirai

从 Github 安装

pip install poetry
git clone https://github.com/GraiaProject/Application graia-app
cd graia-app
poetry install

作出贡献

Graia Framework 欢迎一切形式上的贡献(包括但不限于 Issues, Pull Requests, Good Idea 等)
我们希望能有更多优秀的开发者加入到对项目的贡献上来. 你的 Star 是对我们最大的支持和鼓励.

我们在这里写了你在贡献本项目及 Graia Project 时所可能需要注意的事项.

因为历史原因, 我们的文档, 即 Graia Document 目前急需改进和完善, 如果有意愿, 欢迎提起 Pull Request.

若你在使用的过程中遇到了问题, 欢迎提出聪明的问题, 也请不要使用糟糕的方式提问, 我们希望有人能让这个项目变得更好.

若在使用时发现了本项目的问题, 先检查文档中是否有提及这一情况, 若没有, 你可以在我们的问题追踪器处提出问题, 我们会尽快解决你发现的问题.

你也可以通过 Discussion/QQ 群等方式获取帮助,现在我们更推荐使用 Discussion.

若使用中发现了并非本项目导致的问题, 请先向其他项目汇报问题, 当然, 记得通知我.

鸣谢&相关项目

这些项目也很棒, 去他们的项目页看看, 点个 Star 以鼓励他们的开发工作, 毕竟没有他们也没有 Graia Framework.

特别感谢 mamoe 给我们带来这些精彩的项目:

Graia Application 基于以下独立 Graia Project 项目实现:

Graia Application 同样还关联了其他 Graia Project 项目:

若有相关需求, 我们也强烈建议配合以下独立 Graia Project 项目使用:

作为学习目的, 主要维护者 GreyElaina 以个人名义重新以 AGPL-3.0 开源了 python-mirai, 即 Graia Application 的前身, 希望能为社区的发展助力:

也感谢所有基于本项目开发的各位开发者, 请积极向上游项目反馈问题.

许可证

我们使用 GNU AGPLv3 作为本项目的开源许可证.