0b0f47a444
- Introduced HookHandlerEntry to manage hook processing with attributes like hook name, mode, order, timeout, and error policy. - Implemented normalization methods for hook attributes to ensure valid configurations. - Updated ComponentRegistry to support retrieval of hook handlers based on hook names, with sorting by mode and order. - Refactored HookDispatcher to handle invocation of hooks, separating blocking and non-blocking handlers, and managing execution results. - Added support for registering hook specifications and invoking hooks across supervisors in PluginRuntimeManager. - Removed deprecated workflow step handling from PluginRunner, streamlining hook invocation responses.
Introduction
MaiSaka is an interactive agent based on large language models.
MaiSaka is more than just a bot, and more than a "helpful assistant" that completes tasks. She is a digital life form that tries to understand you and interact in a genuinely human style. She does not pursue perfection or efficiency above all else. She pursues warmth and authenticity.
- 💭 No one likes GPT-sounding dialogue: MaiSaka uses a more natural conversational style. Instead of long-winded markdown-heavy replies, she chats in a way that feels casual, varied, and human.
- 🎭 No longer stuck in rigid Q&A: She knows when to speak, how to read the room, when to join a conversation, and when to stay quiet.
- 🧠 MaiSaka becoming human: In group conversations, MaiSaka imitates how people around her speak, learns new slang and in-group language, and keeps evolving.
- ❤️ Always learning more about you: Inspired by personality theory in psychology, MaiSaka gradually builds an understanding of your preferences, traits, habits, and behavior style.
- 🔌 Plugin system: Provides powerful APIs and an event system with virtually unlimited room for extension.
Quick Navigation
🌟 Demo Video | 📦 Quick Start | 📃 Core Documentation | 💬 Join Community
🔥 Updates and Installation
Latest Version: v1.0.0 (📄 Changelog)
- Download: Visit the Release page to get the latest version.
- Launcher: Mailauncher (MacOS only, still in early development).
| Branch | Description |
|---|---|
main |
✅ Stable release (recommended) |
dev |
🚧 Development testing branch with new features, may be unstable |
📚 Deployment Guide
💬 Discussion and Community
We welcome everyone interested in MaiBot to join us.
| Category | Group | Description |
|---|---|---|
| Technical | MaiBrain EEG | Technical discussion / Q&A |
| Technical | MaiBrain MRI | Technical discussion / Q&A |
| Technical | Mai Wants to Be a VTuber | Technical discussion / Q&A |
| Casual Chat | Mai Casual Chat Group | Casual chat only, no support |
| Plugin Development | Plugin Dev Group | Advanced development and testing |
📚 Documentation
Note
Some content may not be updated promptly, so please pay attention to version compatibility.
- 📚 Core Wiki Documentation: The most comprehensive documentation hub for everything about MaiSaka.
🧩 Related Projects
- Amaidesu: Let MaiSaka stream on Bilibili.
- MoFox_Bot: An enhanced fork based on MaiCore 0.10.0, with improved stability and more fun features.
- MaiCraft: Let MaiSaka accompany you in Minecraft (currently paused).
💡 Design Philosophy
SengokuCola says:
- This project originally started as a few extra features for the NiuNiu bot, but it kept growing until a full rewrite became inevitable. The goal was to create a "life form" active in QQ group chats, not a feature-complete bot, but something as human-like and real-feeling as possible.
- The core design principle is: "more lifelike, not merely better."
- If people truly want AI companionship, not everyone needs a perfect "helpful assistant" that solves every problem. Some people may want a life form that can make mistakes and has its own perceptions and thoughts.
xxxxx says: Code is open, but the soul is yours.
🙋 Contributing and Acknowledgments
Contributions are welcome. Please read the Contribution Guide first.
🌟 Contributors
❤️ Special Thanks
- Sacabambaspis: SengokuCola's favorite creature.
- 略nd: Drew MaiSaka's beautiful early character design.
- NapCat: A modern NTQQ-based bot protocol implementation.
📊 Repository Status
Star History
📌 Notice & License
Important
Please read the End User License Agreement (EULA) and Privacy Policy before use. Please evaluate AI-generated content carefully.
License: GPL-3.0