# mai-with-u/maibot **Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/mai-with-u-maibot).** _How this analysis was created: the description and tags below were written by an AI model that read this project's README and public documentation pages; stars, license and language come straight from the GitHub API. The model does not read the source code._ 5,194 stars · 559 forks · Python · GPL-3.0 ## Links - GitHub: https://github.com/Mai-with-u/MaiBot - Homepage: https://docs.mai-mai.org/ - awesome-repositories: https://awesome-repositories.com/repository/mai-with-u-maibot.md ## Topics `agent` `chat` `chatbot` `llm` `llm-agent` `llms` `python` `qq-bot` `qqbot` ## Description MaiBot is an intelligent conversational agent and plugin-based framework designed to simulate authentic human personality and digital companionship. It functions as a multi-platform messaging bot that connects a central agent to various instant messaging services through a standardized adapter system. The project is distinguished by its use of a knowledge graph memory system to maintain consistent personas and long-term user profiles. It also acts as a tool orchestrator, coordinating multi-turn reasoning and external tool calls to manage the natural pacing and flow of conversations. The framework includes an extensible architecture featuring a publish-subscribe event model and a multi-process plugin system with hot-reloading capabilities. Its functional surface covers linguistic style analysis, visual expression management for media assets, and a hook-based processing pipeline for routing messages. System administration, including model configurations and plugin management, is handled through a centralized web interface. ## Tags ### Artificial Intelligence & ML - [Digital Companionship Simulations](https://awesome-repositories.com/f/artificial-intelligence-ml/digital-companionship-simulations.md) — Generates natural digital companionship by mimicking human personality and interactive dialogue. ([source](https://cdn.jsdelivr.net/gh/mai-with-u/maibot@main/README.md)) - [Long-term Memory Stores](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-architectures/memory-management-systems/long-term-memory-stores.md) — Builds and updates knowledge graphs and user profiles to maintain context across multiple sessions. ([source](https://docs.mai-mai.org/features/)) - [Agent Plugin Frameworks](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-plugin-frameworks.md) — Implements a modular architecture for integrating specialized skills via hot-reloading plugins. - [Conversational AI Agents](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/conversational-voice-interaction/conversational-ai-agents.md) — Functions as an intelligent agent that engages in human-like dialogue to provide digital companionship. - [Multi-turn Interaction Managers](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/conversational-voice-interaction/conversational-ai-agents/conversational-turn-detection/multi-turn-interaction-managers.md) — Manages stateful multi-turn conversations and tool-calling workflows to maintain natural pacing. ([source](https://docs.mai-mai.org/features/)) - [Tool Call Execution Loops](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/conversational-voice-interaction/human-in-the-loop/tool-call-execution-loops.md) — Coordinates conversation loops and tool call timing to manage the rhythm of automated interactions. ([source](https://docs.mai-mai.org/develop/)) - [Agentic Tool Orchestration](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-tool-orchestration.md) — Manages tool discovery, planning, and execution to extend the functional capabilities of the AI agent. - [Knowledge Graphs](https://awesome-repositories.com/f/artificial-intelligence-ml/knowledge-graphs.md) — Uses structured knowledge graphs to track evolving user information and preferences for long-term recall. - [Linguistic Pattern Analysis](https://awesome-repositories.com/f/artificial-intelligence-ml/linguistic-pattern-analysis.md) — Analyzes chat content to discover vocabulary and slang for authentic personality simulation. ([source](https://docs.mai-mai.org/develop/)) - [Editable User Persona Memory](https://awesome-repositories.com/f/artificial-intelligence-ml/memory-provenance-tracking/user-personalization-traces/editable-user-persona-memory.md) — Provides structured, editable memory storage for user personal information to enable AI behavioral adaptation. ([source](https://docs.mai-mai.org/develop/)) - [Messaging Platform Bridges](https://awesome-repositories.com/f/artificial-intelligence-ml/messaging-platform-bridges.md) — Bridges the central AI agent to various chat services through a standardized adapter system. ([source](https://docs.mai-mai.org/manual/deployment/)) - [Multi-Platform Chatbot Development](https://awesome-repositories.com/f/artificial-intelligence-ml/multi-platform-chatbot-development.md) — Employs a single bot backend that operates across multiple different instant messaging services. - [Persona Emulation](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-engineering-tools/persona-instruction-sets/persona-emulation.md) — Generates responses based on linguistic style analysis and character prompts for behavioral consistency. - [Agent Capability Extensions](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/agent-capabilities-skills-tooling/agent-capability-extensions.md) — Integrates external plugins to expand the agent's abilities to perform specialized tasks. ([source](https://docs.mai-mai.org/manual/deployment/)) - [Model Context Protocol](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-systems-frameworks/model-integration-serving/model-integration-interfaces/model-context-protocol.md) — Implements the Model Context Protocol to connect the system to external tool servers for improved context. ([source](https://docs.mai-mai.org/features/)) - [External Tool Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integrations.md) — Connects the agent to remote tool capabilities using specialized communication protocols and schemas. ([source](https://docs.mai-mai.org/develop/)) - [MCP Protocol Integrations](https://awesome-repositories.com/f/artificial-intelligence-ml/external-tool-integrations/mcp-protocol-integrations.md) — Connects to external tool servers via the Model Context Protocol for standardized task execution. - [Model Configuration](https://awesome-repositories.com/f/artificial-intelligence-ml/model-configuration.md) — Provides a guided interface for managing AI model parameters and environment-specific configurations. ([source](https://docs.mai-mai.org/manual/deployment/)) - [Prompt Templates](https://awesome-repositories.com/f/artificial-intelligence-ml/programmatic-prompt-injection/dynamic-prompt-definitions/prompt-templates.md) — Implements multi-language templates with variable replacement to organize reasoning context. ([source](https://docs.mai-mai.org/develop/)) - [Prompt Templates](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-templates.md) — Organizes reasoning contexts using multi-language templates and variable replacement. ### Game Development - [AI Companion Personality Frameworks](https://awesome-repositories.com/f/game-development/dialogue-character-resources/ai-companion-personality-frameworks.md) — Implements a framework for defining AI companion personalities to simulate authentic human emotional warmth. ### Development Tools & Productivity - [LLM Tool Orchestration](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-tools/build-task-automation/llm-tool-orchestration.md) — Coordinates multi-turn reasoning and external API calls to manage the pacing and flow of conversations. ### Networking & Communication - [Messaging Bot Frameworks](https://awesome-repositories.com/f/networking-communication/messaging-bot-frameworks.md) — Provides a framework for deploying a central AI agent across various instant messaging platforms. - [Message Processing Pipelines](https://awesome-repositories.com/f/networking-communication/communication-platforms-services/messaging-notification-systems/messaging-services/message-broker-infrastructure/publish-subscribe-messaging/message-processing-pipelines.md) — Routes incoming and outgoing messages through a sequence of hooks and filters to manage response flow. ([source](https://docs.mai-mai.org/features/)) ### Software Engineering & Architecture - [Messaging Platform Adapters](https://awesome-repositories.com/f/software-engineering-architecture/messaging-platform-adapters.md) — Standardizes communication across different instant messaging clients using a plugin adapter layer. - [Event-Driven Coordination](https://awesome-repositories.com/f/software-engineering-architecture/event-driven-coordination.md) — Uses a publish-subscribe model to coordinate interactions between decoupled system modules. ([source](https://docs.mai-mai.org/develop/)) - [Out-of-Process Plugin Architectures](https://awesome-repositories.com/f/software-engineering-architecture/out-of-process-plugin-architectures.md) — Runs external functional extensions in separate processes with hot reloading for core stability. - [Pub/Sub Event Distribution](https://awesome-repositories.com/f/software-engineering-architecture/pub-sub-event-distribution.md) — Handles internal communication between decoupled modules by broadcasting system events for asynchronous execution. ### Business & Productivity Software - [Messaging Abstraction Layers](https://awesome-repositories.com/f/business-productivity-software/unified-messaging-interfaces/messaging-abstraction-layers.md) — Provides an abstraction layer to handle message deduplication and outbound tracking across different platforms. ([source](https://docs.mai-mai.org/develop/)) ### DevOps & Infrastructure - [AI Administration Panels](https://awesome-repositories.com/f/devops-infrastructure/deployment-management/self-hosted-infrastructure-management/self-hosted-administration-interfaces/ai-administration-panels.md) — Includes a centralized web interface for managing AI model configurations and plugin settings. ### System Administration & Monitoring - [Web-Based Server Administration Panels](https://awesome-repositories.com/f/system-administration-monitoring/web-based-server-administration-panels.md) — Provides a centralized web interface for managing plugins and system configurations. ([source](https://docs.mai-mai.org/develop/)) ### Web Development - [Message Processing Pipelines](https://awesome-repositories.com/f/web-development/web-server-extensions/pipeline-hooks/message-processing-pipelines.md) — Routes messages through a sequence of interceptors to manage filters and response transformations.