This LangBot plugin creates realistic chatbots designed for engaging, authentic chat experiences. It targets users seeking advanced conversational AI, offering dynamic interaction through features like user profiling, emotion sensing, and plot progression, enhancing user engagement beyond standard chatbots.

How It Works

Leveraging the LangBot framework, Waifu integrates LLMs with custom logic for advanced chatbot capabilities. Its architecture includes modules for character management (using LangGPT-formatted cards), dynamic memory summarization, narrative control (via a narrator and plot advancement commands), and sophisticated conversational analysis. It employs prompt engineering and potentially external text analysis APIs to simulate realistic dialogue, user understanding, and emotional responses.

Quick Start & Requirements

• Installation: Install via LangBot admin command: !plugin get https://github.com/ElvisChenML/Waifu.
• Prerequisites: Requires the LangBot main program. Development primarily used Cohere Command R+; compatibility with other LLMs is untested. Configuration involves provider.json, pipeline.json, and config/waifu.yaml, with session-specific overrides.
• Customization: Character cards (.yaml) are stored and managed in data/plugins/Waifu/cards/, supporting per-user or per-group customization.

Highlighted Details

• Advanced User Profiling: Analyzes user personality, life events, and interests to tailor AI responses and conversation style.
• Emotion Sensing: Detects user sentiment and adjusts AI's tone and content accordingly, while also enabling AI to express emotions.
• Dynamic Narrative Control: Features like "Plot Advancement" and "Control Character" allow for interactive storytelling and character-driven dialogue.
• "Jailbreak" Modes: Offers multiple configurations (before, after, end, all) to modify system prompts for potentially enhanced LLM output.
• Per-Session State: Manages independent configurations and conversation memory for each user session.

Maintenance & Community

• Community support is channeled through the LangBot community.
• The project indicates that future development (v2.0+) will transition to a separate, independent project named "Husbando." The current Waifu repository will likely focus on necessary updates and maintenance rather than new feature development.

Licensing & Compatibility

• License: The specific open-source license is not stated in the provided documentation, representing a significant adoption blocker.
• Compatibility: Functionality with other LangBot plugins is not guaranteed and may lead to exceptions.

Limitations & Caveats

• LLM compatibility beyond Cohere Command R+ is untested.
• Potential conflicts exist when running alongside other LangBot plugins.
• Future feature development is migrating to a separate project ("Husbando"), limiting the roadmap for this repository.
• Disabling the "thinking mode" removes the ability to differentiate between multiple users in group chats.
• The absence of a stated license prevents clear understanding of usage rights and restrictions.