# mirai

高效率 QQ 机器人支持库

Repository: https://github.com/mamoe/mirai
Canonical: https://ross.abutalabs.com/products/mirai
Homepage: https://mirai.mamoe.net
Language: Kotlin
License: AGPL-3.0
License Family: copyleft
Topics: java, kotlin, mirai, chatbot
Last push: 2024-09-23T11:25:50+00:00

## Health v2 (maintenance only)
Score: 23/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 8, longevity 100
- inputs: {"age_days": 2583, "days_push": 709, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 14806, forks 2494 (observed 2026-08-28T04:11:07.732093+00:00)

## What it is
mirai is a high-efficiency open-source library implementing the QQ Android protocol for building QQ chatbots on the JVM. It includes mirai-console, a plugin-based bot framework supporting messages, groups, friends, and rich media.

## Use cases
- build a QQ chatbot in Kotlin or Java
- automate group management on QQ
- create a QQ bot plugin with mirai-console
- send and receive QQ messages programmatically
- handle friend requests and group join applications automatically
- forward messages between QQ and other services

## When to choose
- you need a mature, feature-rich library for QQ bot development on the JVM
- you want plugin-based bot deployment via mirai-console
- you need support for rich messages, group admin actions, and file operations on QQ

## When to avoid
- you need a bot for platforms other than QQ
- you require commercial usage, which the project discourages and licenses under AGPL-3.0
- you need money-related or sensitive protocol features, which are explicitly unsupported
- you need a library with guaranteed ongoing updates, as the team may stop development at any time

## Facets
- artifact type: library
- maturity: maintenance
- function: chatbot, sdk, http-server, plugin-system
- domain: chatbots, messaging-platforms, developer-tools
- platform: jvm, cross-platform, cli
- tags: qq-bot, qq-protocol, kotlin, java, bot-framework, instant-messaging, automation

## Member repositories
- mamoe/mirai (main) score 23
- mamoe/mirai-console (plugin) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:07.732093+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:07:08.885674+00:00, confidence not recorded.
  - readme: https://github.com/mamoe/mirai (fetched 2026-08-28T04:11:07.732093+00:00, sha fd1b2472b26c)
- Data as of 2026-08-30T08:39:29.467469+00:00.