MaiBot  by MaiM-with-u

Chatbot for group chats, designed as a cyber friend

created 5 months ago
2,938 stars

Top 16.6% on sourcepulse

GitHubView on GitHub
Project Summary

MaiMBot is an open-source, actively developed AI agent designed for group chat interactions on platforms like QQ. It aims to create a more human-like and engaging conversational experience by simulating thought processes, emotional expression, and persistent memory, moving beyond a simple chatbot to a perceived "life form."

How It Works

MaiMBot is built upon the MaiCore framework, which orchestrates various systems to achieve its human-like interaction. Key components include a natural language interaction system leveraging LLMs, a real-time "mind" system simulating thought, an emotional expression system with rich emoji and GIF support, and a persistent memory system powered by MongoDB for long-term recall. It also features a dynamic personality system for adaptive traits and integrates with a schedule system for intelligent planning.

Quick Start & Requirements

  • Install: The project is under active development, with version 0.6.x requiring a new deployment approach based on MaiCore. Specific installation commands are not detailed in the README, but it mentions interaction via a Nonebot plugin.
  • Prerequisites: Python 3.10+ is required. Interaction with QQ is handled through Nonebot and NTQQ.
  • Resources: The project is in active development, and token consumption may be high.
  • Documentation: Core documentation and deployment tutorials are available at docs.mai-mai.org.

Highlighted Details

  • Human-like Interaction: Focuses on creating a perceived "life form" rather than just a functional bot, prioritizing "most like" over "best."
  • Modular Design: Features distinct systems for chat, "mind," memory, emotion, scheduling, relationships, statistics, tools, and knowledge base (LPMM).
  • Dynamic Personality: Aims for adaptive personality traits and emotional expression, including GIF support.
  • Persistent Memory: Utilizes MongoDB for long-term memory storage and retrieval, simulating a hippocampus.

Maintenance & Community

The project is in active development (status: "开发中"). Community discussion groups are available via QQ (groups listed in README). A contribution guide is mentioned but noted as "待补完" (to be completed).

Licensing & Compatibility

The project is licensed under the MIT license. It is designed for QQ interaction via Nonebot and NTQQ.

Limitations & Caveats

The project is in active development, with code and APIs subject to change. Documentation is incomplete, and users are warned about potential QQ bot restrictions and the possibility of known or unknown bugs. The development philosophy intentionally limits direct control and debugging via explicit commands to enhance the sense of autonomy.

Health Check
Last commit

5 hours ago

Responsiveness

1 day

Pull Requests (30d)
52
Issues (30d)
40
Star History
721 stars in the last 90 days

Explore Similar Projects

Feedback? Help us improve.