Skip to main content

A qbot module with friendly interface, session control and plugin-supported.

Project description

MeloBot

插件化管理、基于异步会话机制的 qbot 开发框架

license MeloBot docs GitHub Repo stars cqhttp

Made with Python PDM - Managed PyPI Code style: black Checked with mypy

郑重承诺和提示: 本项目一切开发旨在学习,请勿用于商业用途和非法用途。任何使用本项目的用户群体,有义务遵守其所在国家或地区的相关法律规定。

🎉 简介

MeloBot 是一个基于 Python 的 qq 机器人开发框架。其以Onebot 标准的实现项目作为前端,通过对来自“前端”的各种“事件”的处理,再产生“行为”,最后提交给“前端”与 qq 服务器交互,即可实现各类复杂的功能。

使用本框架的机器人项目如下:

你可以将这些项目作为 melobot 的使用参考之一。我们也欢迎你基于 melobot 实现机器人后,向文档提出 PR,在此处展示。

✨ 特色

  • 基于 asyncio 的高性能异步
  • 支持插件交互的插件化管理
  • 异步会话控制、自动的会话上下文
  • 事件预检查、预匹配和预解析
  • 支持 bot 生命周期 hook
  • 支持多 bot 协同工作
  • 丰富的接口设计

📦️ 安装使用

通过 pip 命令安装:

pip install melobot

或从源码构建:

本项目通过 pdm 管理,你首先需要安装 pdm

# 随后在本项目根目录:
pdm install

提示:首次运行 pdm 可能需要初始化虚拟环境,请按照 pdm 文档操作。

🪄 版本支持

  • python >= 3.10
  • platform == All
  • OneBot 标准 == 11

❤️ 致谢

MeloBot 的很多设计也是从别处借鉴而来的。虽然 MeloBot 并未直接引用这些项目的代码。

但感谢这些优秀的开源项目,它们间接启发了 MeloBot 的架构设计:

💬 更多

项目文档:MeloBot 文档

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

melobot-2.5.6.tar.gz (852.1 kB view details)

Uploaded Source

Built Distribution

melobot-2.5.6-py3-none-any.whl (86.3 kB view details)

Uploaded Python 3

File details

Details for the file melobot-2.5.6.tar.gz.

File metadata

  • Download URL: melobot-2.5.6.tar.gz
  • Upload date:
  • Size: 852.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.12.4 CPython/3.10.13

File hashes

Hashes for melobot-2.5.6.tar.gz
Algorithm Hash digest
SHA256 2c71b1fdd1a7e13b131cc3df6061443ac795eedf7a86db11cebc63a8bd6634ea
MD5 6a0e488f141586b601b072292ea41ea1
BLAKE2b-256 8c951fdcfc87d64e77aecfc6603cadbc8b086ea39d44d8048e64bfd3bbe6b468

See more details on using hashes here.

File details

Details for the file melobot-2.5.6-py3-none-any.whl.

File metadata

  • Download URL: melobot-2.5.6-py3-none-any.whl
  • Upload date:
  • Size: 86.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: pdm/2.12.4 CPython/3.10.13

File hashes

Hashes for melobot-2.5.6-py3-none-any.whl
Algorithm Hash digest
SHA256 14acdd711fd95f56cafe096b4a361a0e5282ef53728ef98d08e7319f86540ab1
MD5 9b83ccf128ccc6d6cdf86aea050ce087
BLAKE2b-256 a3738829742de213eab18fe4d21e345492e038ba36fd07cc4ca2c160f9045123

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page