Repolode
Submit
ikechan8370

ikechan8370/chatgpt-plugin

A ChatGPT-style AI chat plugin for the Yunzai QQ bot framework, with multi-model channels, memory, RAG and a web admin panel.

View on GitHubWebsite
Stars
1,077
Forks
129
Open issues
25
Last commit
23 days ago

What is it?

ChatGPT-Plugin is an AI chat plugin for Miao-Yunzai and Yunzai-Bot, the QQ bot frameworks. It is built on the Chaite core and packages multiple model channels, tools, processors, triggers, RAG and an admin panel into one plugin. Group members can chat with the bot by @-mention or a configured prefix, and the plugin keeps multi-turn conversation context per user.

Beyond basic chat, the plugin can inject recent group messages into prompts, handle quoted images, voice and multimodal input, and return model-generated images or voice as QQ messages. Its memory service uses a vectra vector index to support group memory, personal memory and external knowledge bases. Data is stored locally in SQLite by default.

Administration works through chat commands or a web panel accessed via a one-time login link. An optional "BYM" mode lets the bot speak unprompted based on probability or keyword matches, with configurable presets and auto-recall.

Key features

  • 01Supports multiple model channels with per-model presets and load balancing.
  • 02Triggers via @-mention or a configurable prefix, with multi-turn context per user.
  • 03Injects recent group chat history into prompts when enabled.
  • 04Handles images, voice and quoted messages as multimodal input.
  • 05Provides group and personal memory backed by a vectra vector index.
  • 06Offers a web admin panel plus full command-line CRUD for channels, tools and triggers.

Use cases

  • Adding an AI chat assistant to a QQ group run by Yunzai-based bots.
  • Giving a group bot memory of past conversations and member preferences.
  • Running a playful bot that replies unprompted by keyword or probability.
  • Connecting a self-hosted bot to multiple LLM providers from one place.

Quick start

  1. 1

    Clone the repository into the Yunzai plugins folder

    git clone https://github.com/ikechan8370/chatgpt-plugin.git
  2. 2

    Install dependencies inside the chatgpt-plugin folder (Node.js 18+ and pnpm 8+ recommended)

    pnpm install
  3. 3

    Restart the bot so the plugin loads automatically

    node app

Things to know

  • It is a plugin for the Yunzai QQ bot framework and does not run on its own.
  • The README says the v3 refactor is still in progress, and some planned features such as RAG knowledge base and MCP support are unchecked.
  • Licensed under GPL-3.0, a copyleft license that requires derivative works to remain open source.

In collections

AI chatbots & chat clients

Topics

#chatgpt#qq-bot#yunzai#llm#rag#chatbot#vector-search#bot#qq#yunzai-bot

FAQ

What is chatgpt-plugin?
A ChatGPT-style AI chat plugin for the Yunzai QQ bot framework, with multi-model channels, memory, RAG and a web admin panel. ChatGPT-Plugin is an AI chat plugin for Miao-Yunzai and Yunzai-Bot, the QQ bot frameworks. It is built on the Chaite core and packages multiple model channels, tools, processors, triggers, RAG and an admin panel into one plugin. Group members can chat with the bot by @-mention or a configured prefix, and the plugin keeps multi-turn conversation context per user.
Is chatgpt-plugin free to use? What license does it have?
chatgpt-plugin is open source under the GPL-3.0 license. Check the license terms before using it in commercial products.
Is chatgpt-plugin still maintained?
Actively maintained. The last commit to chatgpt-plugin was on Oct 15, 2026.
What can I use chatgpt-plugin for?
Adding an AI chat assistant to a QQ group run by Yunzai-based bots. Giving a group bot memory of past conversations and member preferences. Running a playful bot that replies unprompted by keyword or probability. Connecting a self-hosted bot to multiple LLM providers from one place.
How do I install chatgpt-plugin?
Clone the repository into the Yunzai plugins folder: git clone https://github.com/ikechan8370/chatgpt-plugin.git Install dependencies inside the chatgpt-plugin folder (Node.js 18+ and pnpm 8+ recommended): pnpm install Restart the bot so the plugin loads automatically: node app
Where can I get chatgpt-plugin?
The source code and installation instructions are on GitHub: https://github.com/ikechan8370/chatgpt-plugin

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

Related projects