README_EN.md

August 23, 2026 · View on GitHub

MaiBot

License Contributors Forks Stars

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.

🌟 Demo Video | 📦 Quick Start | 📃 Core Documentation | 💬 Join Community

Watch the MaiSaka demo video

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

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.