# Mai-with-u/MaiBot

MaiSaka, an LLM-based intelligent agent, is a digital lifeform devoted to understanding you and interacting in the style of a real human. She does not pursue perfection, nor does she seek efficiency; instead, she values warmth, authenticity, and genuine connection.

Repository: https://github.com/Mai-with-u/MaiBot
Canonical: https://ross.abutalabs.com/products/maibot
Homepage: https://docs.mai-mai.org/
Language: Python
License: GPL-3.0
License Family: copyleft
Topics: chat, llm, python, qq-bot, qqbot, agent, chatbot, llm-agent, llms
Last push: 2026-08-26T01:24:33+00:00

## Health v2 (maintenance only)
Score: 87/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 99, longevity 39
- inputs: {"age_days": 554, "days_push": 8, "days_rel": 10, "gap_med": 5, "n_releases_24m": 54}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5821, forks 601 (observed 2026-08-28T04:09:30.050761+00:00)

## What it is
MaiBot (MaiSaka) is an open-source, LLM-powered conversational agent designed to behave like a warm, human-like 'digital life form' in QQ group chats rather than a task-oriented assistant. It features natural casual dialogue, smart timing for when to speak, long-term memory with knowledge graphs and user personas (A-Memorix), style/slang learning from group members, a VLM-based emoji/sticker system, MCP tool integration, a plugin SDK, and a WebUI for configuration.

## Use cases
- run a human-like AI chatbot in a QQ group
- build an LLM companion bot that remembers users over time
- make a group chat bot that learns slang and mimics members' speaking style
- self-host an LLM agent with long-term memory and persona profiles
- extend a chatbot with plugins and MCP tools
- deploy a chatbot that knows when to speak and when to stay quiet

## When to choose
- you want a lifelike, casual conversational companion for QQ group or private chats rather than a formal Q&A assistant
- you need long-term memory, user personas, and style/slang learning in a chatbot
- you want a plugin system, MCP tool support, and a WebUI for managing model providers and adapters

## When to avoid
- you need a task-oriented assistant that reliably completes work or answers questions accurately
- you only target platforms other than QQ without writing or finding an adapter
- you require strict, predictable, markdown-formatted responses or enterprise-grade compliance

## Facets
- artifact type: application
- maturity: active
- function: chatbot, agent-framework, llm-inference, rag, mcp, plugin-system, nlp
- domain: chatbots, artificial-intelligence, large-language-models, messaging-platforms
- platform: python, self-hosted, cross-platform
- tags: qq-bot, llm-agent, long-term-memory, persona, group-chat, digital-companion, webui, expression-learning, ai-agents, natural-language-processing, docker

## Member repositories
- Mai-with-u/MaiBot (main) score 87

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:30.050761+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:52:10.923841+00:00, confidence not recorded.
  - readme: https://github.com/Mai-with-u/MaiBot (fetched 2026-08-28T04:09:30.050761+00:00, sha 8ab30c93fab2)
  - homepage: https://docs.mai-mai.org/ (fetched 2026-08-29T08:47:45.789050+00:00, sha 17725032db70)
  - site_page: https://docs.mai-mai.org/faq (fetched 2026-08-29T08:47:45.798265+00:00, sha 31fc6b263e5a)
  - site_page: https://docs.mai-mai.org/changelog (fetched 2026-08-29T08:47:45.800140+00:00, sha 2ec9244c30b4)
  - site_page: https://docs.mai-mai.org/about (fetched 2026-08-29T08:47:45.802211+00:00, sha feb367f85167)
  - site_page: https://docs.mai-mai.org/features (fetched 2026-08-29T08:47:45.804155+00:00, sha 4d9d59b4a4e4)
  - site_page: https://docs.mai-mai.org/manual/features/memory-system (fetched 2026-08-29T08:47:45.805855+00:00, sha a346f44d59fe)
  - site_page: https://docs.mai-mai.org/manual/features/learning (fetched 2026-08-29T08:47:45.847860+00:00, sha 10a7d01701ad)
  - site_page: https://docs.mai-mai.org/about/community (fetched 2026-08-29T08:47:45.877944+00:00, sha 0e9ee7a880a4)
  - site_page: https://docs.mai-mai.org/about/acknowledgements (fetched 2026-08-29T08:47:45.879978+00:00, sha 522aa754b3d7)
- Data as of 2026-08-30T08:39:29.467469+00:00.