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

---

Installation

Latest Version: v1.2.3

• Download: Visit the Release page to get the latest version.

• Deployment Guide

• Easy-to-use MaiBot launcher (Windows/macOS): Maibot-OK

Branch	Description
main	Stable
dev	Development branch with features currently in development

---

📚 Documentation

• 📚 MaiBot Documentation: The most comprehensive documentation hub for everything about MaiSaka.

---

💬 Discussion and Community

Group	Description
MaiBrain EEG: 571780722	Technical discussion / Q&A
MaiBrain MRI: 766798517	Technical discussion / Q&A
Mai Wants to Be a VTuber	Technical discussion / Q&A
Mai Casual Chat Group	Casual chat only, no support
Plugin Dev Group: 1036092828	Advanced development and testing

---

🧩 Related Projects

• Amaidesu: Let MaiSaka stream on Bilibili.
• MoFox_Bot: An enhanced fork based on MaiCore 0.10.0.
• MaiCraft: Let MaiSaka accompany you in Minecraft (currently paused).

---

💡 Design Philosophy

SengokuCola:

• 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.

---

🌟 Contributing and Acknowledgments

Contributions are welcome. Please read the Contribution Guide first.

🌟 Contributors

🤝 Open Source Friends

• AstrBot: An excellent LLM Agent project.

❤️ 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