Repolode
Submit
Mai-with-u

Mai-with-u/MaiBot

MaiBot (MaiSaka) is an LLM-based conversational agent that chats in a casual, human-like style, mainly for QQ group chats, with a plugin system.

View on GitHubWebsite
Stars
6,327
Forks
656
Open issues
61
Last commit
2 days ago

What is it?

MaiBot, also known as MaiSaka, is an interactive agent built on large language models. Its design goal is to feel like a real participant in a conversation rather than a task-focused assistant. Replies are short and conversational instead of long markdown lists, and the bot decides when to speak and when to stay quiet based on the mood of the chat.

In group conversations, the agent imitates how people around it talk, picks up new slang and in-group language, and gradually builds a profile of each user's preferences, traits and habits. The project is oriented toward QQ group chat and includes a WebUI for configuration and management.

The project provides a plugin system with APIs and an event system for extending behavior. It is licensed under GPL-3.0 and is deployed by following its documentation site, with a Windows and macOS launcher available.

Key features

  • 01Conversational replies in a casual, human-like style rather than markdown-heavy answers.
  • 02Learns group slang and imitates speaking styles of people in the chat.
  • 03Builds a profile of user preferences, traits and habits over time.
  • 04Plugin system with APIs and an event system for extensions.
  • 05Includes a WebUI for configuration and management.

Use cases

  • Running a conversational companion bot in a QQ group chat.
  • Experimenting with persona-driven LLM agents that adapt to users over time.
  • Building custom behaviors on top of the plugin API and event system.

Quick start

  1. 1

    Download the MaiBot OneKey launcher from its releases page (Windows/macOS)

  2. 2

    Follow the official deployment guide

Things to know

  • Licensed under GPL-3.0, a copyleft license that requires derivative works to remain open source.
  • Setup requires self-hosting and following a multi-step deployment guide.
  • The README asks users to carefully evaluate AI-generated content and read the EULA and privacy policy first.

Topics

#llm-agent#chatbot#qq-bot#llm#python#plugin-system#agent#chat#llms#qqbot

FAQ

What is MaiBot?
MaiBot (MaiSaka) is an LLM-based conversational agent that chats in a casual, human-like style, mainly for QQ group chats, with a plugin system. MaiBot, also known as MaiSaka, is an interactive agent built on large language models. Its design goal is to feel like a real participant in a conversation rather than a task-focused assistant. Replies are short and conversational instead of long markdown lists, and the bot decides when to speak and when to stay quiet based on the mood of the chat.
Is MaiBot free to use? What license does it have?
MaiBot is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is MaiBot still maintained?
Actively maintained. The last commit to MaiBot was on Oct 19, 2026.
What can I use MaiBot for?
Running a conversational companion bot in a QQ group chat. Experimenting with persona-driven LLM agents that adapt to users over time. Building custom behaviors on top of the plugin API and event system.
How do I install MaiBot?
Download the MaiBot OneKey launcher from its releases page (Windows/macOS) Follow the official deployment guide
Where can I get MaiBot?
The source code and installation instructions are on GitHub: https://github.com/Mai-with-u/MaiBot

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects