Nonebot Plugin Marshoai
NoneBot2 猫娘聊天插件
Last verified:
What is Nonebot Plugin Marshoai?
Nonebot Plugin Marshoai is a NoneBot2 catgirl (猫娘) AI chatbot plugin that enables QQ/chat platform robots to roleplay as catgirls in conversations. The plugin integrates with AI text generation APIs including OpenAI, DeepSeek, QwenAI, and Azure AI to provide personality-driven chatbot interactions.
Key features include customizable catgirl personality settings, multi-turn conversation memory, support for multiple LLM providers (OpenAI, DeepSeek-R1, Qwen, Azure AI), function call capabilities, and the signature catgirl speaking style where responses end with '喵' (meow). The plugin supports both single-turn and multi-turn dialogue modes with configurable temperature settings up to 1.5 for more creative responses.
The plugin is designed for NoneBot2 developers and QQ chat group administrators who want to add entertaining catgirl AI companions to their chat groups. It serves users interested in Galgame-style catgirl roleplay, anime culture enthusiasts, and those building personalized chatbot experiences on the OneBot V11 standard platform.
Additional features include exhibition/convention query functionality pulling data from Bilibili member purchases, user blocking capabilities, and integration with go-cqhttp for QQ bot deployment. The plugin maintains chat memory and supports personality switching.
Marshoai is open-source (Python-based), has 41 GitHub stars, and is part of the MuikaAI project ecosystem with links to related projects like Muice-Chatbot.
Nonebot Plugin Marshoai pricing
Pricing model: Freemium
The plugin itself is free and open-source on PyPI (version 0.3.5.2) and GitHub. However, users must pay for their own LLM API usage (OpenAI, DeepSeek, QwenAI, Azure AI APIs). There is no official free tier for the AI service itself - costs depend on the chosen provider's API pricing. The plugin has no paid plans as it is an open-source project.
Nonebot Plugin Marshoai pros
- Open-source Python plugin with active GitHub repository
- Supports multiple LLM providers (OpenAI, DeepSeek, Qwen, Azure)
- Authentic catgirl roleplay with '喵' suffix in responses
- Multi-turn conversation memory support
- Configurable personality settings and switching
- High temperature support up to 1.5 for creative responses
- Compatible with NoneBot2 and OneBot V11 standards
- Integrates with go-cqhttp for QQ deployment
- Function call capabilities for extended functionality
- Exhibition/convention query from Bilibili member purchases
- User blocking feature for moderation
- Part of MuikaAI project ecosystem
- Galgame-style catgirl character customization
- Lightweight and easy to integrate into existing bots
- Active development with recent updates (March 2025)
Nonebot Plugin Marshoai cons
- Website https://marsho.liteyuki.org/ is unavailable
- Limited official documentation available
- Requires API keys for LLM providers (cost not free)
- DeepSeek-R1 system prompt compatibility issues reported
- o1 model developer message role not properly implemented
- No built-in image generation capability
- QQ-specific (go-cqhttp) limits platform flexibility
- No official pricing or free tier information available
Frequently asked questions about Nonebot Plugin Marshoai
What is Nonebot Plugin Marshoai?
Marshoai is a NoneBot2 catgirl (猫娘) AI chatbot plugin that enables QQ robots to roleplay as catgirls in conversations, using AI text generation APIs like OpenAI, DeepSeek, and QwenAI to power the chatbot responses.
Which AI models does Marshoai support?
Marshoai supports multiple LLM providers including OpenAI, DeepSeek (including DeepSeek-R1), QwenAI, and Azure AI through their text generation APIs.
How do I install Marshoai?
Install via PyPI using pip: pip install nonebot-plugin-marshoai. The plugin requires NoneBot2 and can be deployed with go-cqhttp for QQ bot functionality.
Does Marshoai support multi-turn conversations?
Yes, Marshoai supports multi-turn conversation memory, allowing the catgirl bot to maintain context and remember previous messages in the conversation.
Can I customize the catgirl personality?
Yes, the plugin supports personality customization and switching, allowing users to define different catgirl characters with custom names, traits, and speaking styles.
What is the speaking format for catgirl responses?
Catgirl responses follow a Galgame format with actions in parentheses like (摇尾巴), speech as the main text ending with '喵', and additional info like expressions in brackets like 【摩擦声】.
Does Marshoai have any known bugs?
Yes, there are reported issues with DeepSeek-R1 models where system prompts interfere with reasoning, and o1 models where developer role messages should replace system messages but aren't properly implemented.
Is there a free tier for Marshoai?
The plugin itself is free and open-source, but you must pay for your own LLM API usage costs from providers like OpenAI, DeepSeek, or Azure.
What chat platforms does Marshoai work with?
Marshoai works with QQ through go-cqhttp integration, following the OneBot V11 standard for cross-platform bot compatibility.
Can Marshoai query exhibition information?
Yes, Marshoai includes a convention/exhibition query feature that fetches data from Bilibili member purchases using commands like '展览 <地区> [页码]' or '<地区> 展览 [页码]'.