e26b27c287
- Changed the message sending method to return DeliveryBatch instead of DeliveryReceipt in integration.py. - Removed AdapterDeclarationPayload and related references from envelope.py, replacing them with MessageGatewayStateUpdatePayload and MessageGatewayStateUpdateResultPayload. - Updated runner_main.py to remove adapter-related logic and methods, focusing on message gateway functionality. - Added tests for message gateway runtime state synchronization and action bridge functionality in test files.
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