{"id":13815119,"url":"https://github.com/GraiaProject/Ariadne","last_synced_at":"2025-05-15T07:31:57.118Z","repository":{"id":37033794,"uuid":"417875186","full_name":"GraiaProject/Ariadne","owner":"GraiaProject","description":"一个优雅且完备的 Python QQ 自动化框架，基于 Mirai API HTTP v2。    Powered by Graia Project.","archived":false,"fork":false,"pushed_at":"2025-04-07T18:13:42.000Z","size":3665,"stargazers_count":782,"open_issues_count":7,"forks_count":46,"subscribers_count":5,"default_branch":"dev","last_synced_at":"2025-05-12T17:28:51.335Z","etag":null,"topics":["ariadne","asyncio","automation","bot","chatbot","framework","graia","graiaproject","mirai","mirai-api-http","python","qq","qqbot"],"latest_commit_sha":null,"homepage":"https://graia.cn/ariadne","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GraiaProject.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"custom":["https://graia.readthedocs.io/ariadne/appendix/funding"]}},"created_at":"2021-10-16T15:53:38.000Z","updated_at":"2025-05-12T16:00:58.000Z","dependencies_parsed_at":"2024-06-18T18:30:18.152Z","dependency_job_id":"39b76010-aeac-475c-bb24-13e1c2c2a408","html_url":"https://github.com/GraiaProject/Ariadne","commit_stats":null,"previous_names":[],"tags_count":116,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraiaProject%2FAriadne","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraiaProject%2FAriadne/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraiaProject%2FAriadne/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GraiaProject%2FAriadne/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GraiaProject","download_url":"https://codeload.github.com/GraiaProject/Ariadne/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254295945,"owners_count":22047175,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ariadne","asyncio","automation","bot","chatbot","framework","graia","graiaproject","mirai","mirai-api-http","python","qq","qqbot"],"created_at":"2024-08-04T04:02:58.750Z","updated_at":"2025-05-15T07:31:55.764Z","avatar_url":"https://github.com/GraiaProject.png","language":"Python","funding_links":["https://graia.readthedocs.io/ariadne/appendix/funding"],"categories":["Python"],"sub_categories":[],"readme":"\u003cdiv align=\"center\"\u003e\n\n# Ariadne\n\n_Another elegant framework for mirai and mirai-api-http v2._\n\n\u003e 接受当下, 面向未来.\n\n[![PyPI](https://img.shields.io/pypi/v/graia-ariadne)](https://pypi.org/project/graia-ariadne)\n[![Python Version](https://img.shields.io/pypi/pyversions/graia-ariadne)](https://pypi.org/project/graia-ariadne)\n\n[![Code style: black](https://img.shields.io/badge/code%20style-black-000000.svg)](https://github.com/psf/black)\n[![Imports: isort](https://img.shields.io/badge/%20imports-isort-%231674b1?style=flat\u0026labelColor=ef8336)](https://pycqa.github.io/isort/)\n[![License](https://img.shields.io/github/license/GraiaProject/Ariadne)](https://github.com/GraiaProject/Ariadne/blob/master/LICENSE)\n[![pdm-managed](https://img.shields.io/badge/pdm-managed-blueviolet)](https://pdm.fming.dev)\n\n|文档|[![docs](https://img.shields.io/badge/readthedocs-gray)](https://graia.readthedocs.io/)|[![docs](https://img.shields.io/badge/netlify-28afa0)](https://graia.netlify.app/)|[![docs](https://img.shields.io/badge/cloudflare-orange)](https://graia.pages.dev/)|\n|:-:|:-:|:-:|:-:|\n\n|API 参考|[![docs](https://img.shields.io/badge/readthedocs-gray)](https://graia.readthedocs.io/projects/ariadne)|[![docs](https://img.shields.io/badge/netlify-28afa0)](https://graia-ariadne.netlify.app/)|[![docs](https://img.shields.io/badge/cloudflare-orange)](https://graia-ariadne.pages.dev/)|\n|:-:|:-:|:-:|:-:|\n\n\n\u003c/div\u003e\n\n**本项目适用于 mirai-api-http 2.0 以上版本**.\n\nAriadne 是 `Graia Project` 继承了 [`Application`](https://github.com/GraiaProject/Application) 并进行了许多改进后产生的作品,\n相信它可以给你带来良好的 `Python QQ Bot` 开发体验.\n\n**注意, 本框架需要 [`mirai-api-http v2`](https://github.com/project-mirai/mirai-api-http).**\n\n## 安装\n\n`pdm add graia-ariadne`\n\n或\n\n`poetry add graia-ariadne`\n\n或\n\n`pip install graia-ariadne`\n\n\u003e 我们强烈建议使用 [`pdm`](https://pdm.fming.dev) / [`poetry`](https://python-poetry.org) 进行包管理\n\n## 开始使用\n\n```python\nfrom graia.ariadne.app import Ariadne\nfrom graia.ariadne.connection.config import config\nfrom graia.ariadne.model import Friend\n\napp = Ariadne(config(verify_key=\"ServiceVerifyKey\", account=123456789))\n\n\n@app.broadcast.receiver(\"FriendMessage\")\nasync def friend_message_listener(app: Ariadne, friend: Friend):\n    await app.send_message(friend, \"Hello, World!\")\n\n\nAriadne.launch_blocking()\n```\n\n更多信息请看\n[![快速开始](https://img.shields.io/badge/文档-快速开始-blue)](https://graia.readthedocs.io/ariadne/quickstart/)\n\n## 讨论\n\nQQ 交流群: [邀请链接](https://jq.qq.com/?_wv=1027\u0026k=VXp6plBD)\n\n\u003e QQ 群不定时清除不活跃成员, 请自行重新申请入群.\n\n## 文档\n\n[![API 文档](https://img.shields.io/badge/API_文档-here-purple)](https://graia.readthedocs.io/projects/ariadne/)\n[![官方文档](https://img.shields.io/badge/官方文档-here-blue)](https://graia.readthedocs.io/ariadne/)\n[![社区文档](https://img.shields.io/badge/社区文档-here-pink)](https://graiax.cn)\n[![鸣谢](https://img.shields.io/badge/鸣谢-here-lightgreen)](https://graia.readthedocs.io/ariadne/appendix/credits)\n\n**如果认为本项目有帮助, 欢迎点一个 `Star`.**\n\n## 协议\n\n本项目以 [`GNU AGPL-3.0`](https://choosealicense.com/licenses/agpl-3.0/) 作为开源协议, 这意味着你需要遵守相应的规则.\n\n## 持续集成 (CI) 状态\n\n[![API Doc Status](https://readthedocs.org/projects/graia-ariadne/badge/?version=latest)](https://graia.readthedocs.io/projects/ariadne/)\n[![pre-commit.ci status](https://results.pre-commit.ci/badge/github/GraiaProject/Ariadne/master.svg)](https://results.pre-commit.ci/latest/github/GraiaProject/Ariadne/master)\n\n[![API 文档构建](https://github.com/GraiaProject/Ariadne/actions/workflows/deploy-docs.yml/badge.svg)](https://github.com/GraiaProject/Ariadne/actions/workflows/deploy-docs.yml)\n[![发布](https://github.com/GraiaProject/Ariadne/actions/workflows/release.yml/badge.svg)](https://github.com/GraiaProject/Ariadne/actions/workflows/release.yml)\n\n## 参与开发\n\n[贡献指南](./CONTRIBUTING.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGraiaProject%2FAriadne","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGraiaProject%2FAriadne","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGraiaProject%2FAriadne/lists"}