# lss233/chatgpt-mirai-qq-bot

**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/lss233-chatgpt-mirai-qq-bot).**

_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._

18,814 stars · 1,833 forks · Python · AGPL-3.0

## Links

- GitHub: https://github.com/lss233/chatgpt-mirai-qq-bot
- Homepage: https://kirara-docs.app.lss233.com/
- awesome-repositories: https://awesome-repositories.com/repository/lss233-chatgpt-mirai-qq-bot.md

## Description

This project is a messaging bot bridge and multi-model AI gateway that connects large language models to platforms such as QQ, Telegram, and WeChat. It functions as an AI agent workflow engine, enabling the automation of private and group chat interactions across multiple social communication channels.

The system features a multimodal chat interface capable of processing and sending text, voice, and AI-generated images. It includes a web-based management dashboard for administering AI model configurations, monitoring activity, and designing custom bot personalities and persona presets to control the tone and behavior of responses.

The platform supports integration with various AI providers, including OpenAI, Claude, Gemini, and locally hosted Ollama instances. Its broader capabilities cover automated AI workflows, stateful conversation tracking for multi-turn exchanges, and text-to-speech conversion for voice-enabled interactions.

## Tags

### Artificial Intelligence & ML

- [Messaging Platform Bridges](https://awesome-repositories.com/f/artificial-intelligence-ml/messaging-platform-bridges.md) — Bridges large language models with messaging platforms like QQ, Telegram, and WeChat to automate private and group chats. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))
- [Agent Persona Configurations](https://awesome-repositories.com/f/artificial-intelligence-ml/agent-persona-configurations.md) — Allows the definition of behavioral traits and operational identities to control the tone of AI agent responses. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))
- [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 the state of multi-turn dialogues to ensure coherent follow-up answers based on previous exchange history. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))
- [Agentic Workflow Engines](https://awesome-repositories.com/f/artificial-intelligence-ml/agentic-workflow-engines.md) — Functions as a programmable engine for executing autonomous agent tasks and managing conversation state.
- [Multimodal Capabilities](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-chatbots/multimodal-capabilities.md) — Ships a multimodal interface capable of processing and sending text, voice, and AI-generated images.
- [AI Gateways](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-gateways.md) — Provides a unified gateway to route requests across multiple AI providers including OpenAI, Claude, Gemini, and Ollama.
- [AI Workflow Automation](https://awesome-repositories.com/f/artificial-intelligence-ml/ai-workflow-automation.md) — Provides a workflow engine for designing conditional triggers and automated steps to handle complex user requests in chat.
- [Platform Normalization Adapters](https://awesome-repositories.com/f/artificial-intelligence-ml/bot-platforms/platform-normalization-adapters.md) — Provides adapters that translate platform-specific webhooks and message formats from services like QQ and Telegram into a unified internal schema.
- [Conversation State Management](https://awesome-repositories.com/f/artificial-intelligence-ml/conversation-state-management.md) — Maintains per-user message history in a backend store to track context across multi-turn conversational interactions.
- [Persona Configurations](https://awesome-repositories.com/f/artificial-intelligence-ml/custom-ai-assistant-development/persona-configurations.md) — Enables the design of custom bot personalities and persona presets to control the tone and behavior of AI responses.
- [Persona Instruction Sets](https://awesome-repositories.com/f/artificial-intelligence-ml/prompt-engineering-tools/persona-instruction-sets.md) — Allows the use of behavioral directives and system instructions to constrain model output to specific professional roles or personas.
- [Provider-Agnostic Model Interfaces](https://awesome-repositories.com/f/artificial-intelligence-ml/provider-agnostic-model-interfaces.md) — Provides an abstraction layer that standardizes inputs and outputs across multiple LLM providers like OpenAI, Claude, and Gemini.
- [Conversational AI Backends](https://awesome-repositories.com/f/artificial-intelligence-ml/conversational-ai-backends.md) — Implements a backend system for managing AI model configurations and persistent conversation contexts.

### Networking & Communication

- [AI Messaging Bridges](https://awesome-repositories.com/f/networking-communication/message-bridges/ai-messaging-bridges.md) — Acts as an integration layer connecting large language models to messaging platforms like QQ, Telegram, and WeChat.
- [Messaging Client Connections](https://awesome-repositories.com/f/networking-communication/communication-protocols-architectures/communication-protocols-standards/network-protocols/connection-establishment-protocols/messaging-client-connections.md) — Implements the connectivity layer required to accept incoming traffic from various messaging client protocols. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))
- [Messaging Bot Frameworks](https://awesome-repositories.com/f/networking-communication/messaging-bot-frameworks.md) — Provides a framework for building and deploying AI-powered bots across multiple instant messaging platforms like QQ and WeChat.

### Development Tools & Productivity

- [AI Workflow Designers](https://awesome-repositories.com/f/development-tools-productivity/workflow-automation-triggers/ai-workflow-designers.md) — Enables the design of automated sequences and conditional triggers to handle complex user requests via AI agents. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))

### Software Engineering & Architecture

- [Workflow Logic Engines](https://awesome-repositories.com/f/software-engineering-architecture/workflow-logic-engines.md) — Provides a workflow engine to execute sequences of conditional logic for complex tasks such as web searching or image generation.
- [Web-Based Configuration Dashboards](https://awesome-repositories.com/f/software-engineering-architecture/application-lifecycle-management/configuration-management/configuration-interfaces-and-editors/web-based-configuration-generators/web-based-configuration-dashboards.md) — Ships a web-based configuration dashboard for updating bot settings and persona configurations in real time via a REST API.
- [Prompt Presets](https://awesome-repositories.com/f/software-engineering-architecture/project-management-governance/project-management/project-lifecycle-management/project-configuration-presets/configuration-presets/prompt-presets.md) — Provides predefined sets of system instructions and model configurations to steer the AI's personality and tone. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))

### DevOps & Infrastructure

- [Message Queues](https://awesome-repositories.com/f/devops-infrastructure/message-queues.md) — Implements asynchronous task buffering to prevent blocking the system during long AI model response generations.

### System Administration & Monitoring

- [Web Management Dashboards](https://awesome-repositories.com/f/system-administration-monitoring/administrative-operations/remote-access-interface-tools/administrative-interfaces/management-interfaces/web-management-dashboards.md) — Provides a browser-based interface for monitoring agent activity and configuring service settings remotely. ([source](https://github.com/lss233/chatgpt-mirai-qq-bot#readme))

### User Interface & Experience

- [Multimodal Chat Clients](https://awesome-repositories.com/f/user-interface-experience/multimodal-chat-clients.md) — Implements a chat interface that supports multimodal interactions across various social communication channels.

### Part of an Awesome List

- [Chatbot Integrations](https://awesome-repositories.com/f/awesome-lists/media/chatbot-integrations.md) — QQ bot supporting text-to-image conversion and proxy settings.
