mirai (mamoe/mirai)
Searching Database…
What is this?
Mirai is a high-efficiency Kotlin library that implements the QQ Android protocol, letting developers build bots that interact with Tencent's QQ chat platform.
Is this a standalone bot app or a library I build on top of?
It is a library/framework: you write Kotlin or Java code against mirai's APIs, or install a prebuilt loader and drop in plugins, to run your own QQ bot.
How do I get a bot running quickly?
For a quick deployment with plugins, follow the official User Manual; for custom development, add mirai as a dependency and read the developer docs on GitHub or docs.mirai.mamoe.net.
Do I need a JVM toolchain to use it?
Yes, mirai is written in Kotlin and targets JVM-based languages, so you need a Java/Kotlin development environment to build or extend it.
What kinds of actions will mirai refuse to support?
Mirai deliberately excludes money-related actions (likes, payments), sensitive operations like auto-adding friends or auto-joining groups, and anything that extracts login credentials such as tokens or cookies.
Who is this for, legally speaking?
It's aimed at developers learning or experimenting; the project explicitly states it's for study and entertainment purposes only and must not be used for illegal purposes.
What messaging features does mirai support out of the box?
It supports text, stickers, images, XML/JSON rich messages, long messages (5000+ chars, 50+ images), quote-replies, forwarded messages, recalls, @mentions, voice, flash photos, music sharing, and short videos.
Can mirai manage group and friend operations too?
Yes: it can list and manage group members and permissions, mute users, handle join requests, manage group files and announcements, and handle friend requests and removals.
Is mirai free to use?
Yes, it is completely free and open source; optional sponsorship exists to fund community infrastructure but grants no special privileges.
Where does the name mirai come from?
The project's name and mascot/icon were created by an illustrator, referencing the Japanese word 'mirai' (future).
What are similar projects?
wechaty, kirara-ai, NapCatQQ, ItChat, python-telegram-bot, Telethon, jev-chat-jarvis, EverydayWechat

