Waifu Companion

🌐 Language Settings

🌍 Language

🔤 Show Transliteration (for JA, KO)

🈯 Translate User Interface (AI)

🤖 LLM / OpenRouter

Use OpenRouter instead of built-in WebSim LLM

When enabled, chat, translation, and summarization will call OpenRouter using your API key and model name.

🔑 OpenRouter API Key

This is stored locally in your browser only and sent directly to openrouter.ai over HTTPS.

🧬 OpenRouter Model Name

Examples: stepfun/step-3.5-flash:free, penrouter/free, arcee-ai/trinity-large-preview:free, etc.

🔄 Fallback Model 1

First fallback model. Used if the primary model fails.

🔄 Fallback Model 2

Second fallback model. Used if the primary and first fallback models fail.

🧩 Model Settings

🎭 Select Model

➕ Add Custom Model

📂 Custom Models

🧠 Persona System Prompt

🆔 Core Identity

🎭 Custom Personality / Roleplay

🧠 Memory Settings

🧵 Conversation Memory Size

Current: 30 messages

⏲️ Summary Trigger (Every N messages)

Trigger after: 30 messages

📏 Summary Target Length

📝 Conversation Summary

🧠 Context Settings

⏱️ Include current time in context

Provides the AI with the current date and time for context-aware responses.

🔋 Include battery status in context

Allows the AI to know your device's battery level and charging state.

📖 Include Tutorial in AI Context

🤖 Allow AI to modify settings

📝 Use JSON Format for Emotion (Advanced)

Forces the AI to respond in JSON for emotional reactions, but may cause errors on weaker LLMs.

🔊 Voice Settings

🔈 Enable Primary Voice (WebSim)

🚀 Enable Local Voice (Kokoro)

🔄 Enable Fallback Voice (Browser)

🎙️ Voice

🚀 Kokoro Voice

High-quality local TTS. Preloaded in background for silent handoff.

🔄 Fallback Voice

Used automatically if the primary voice provider fails (e.g. rate limit).

📏 TTS Chunk Character Limit

Max Characters: 300

🔉 TTS Voice Volume

Volume: 1.00

🎧 Audio Settings

📻 Radio Stream

🖥️ Display Settings

⏰ Show Clock

🪟 Chatbox Opacity

Current: 0.9

💬 Message Bubble Opacity

Current: 0.3

🖼️ Background Image Opacity

Current: 1.0

🖼️ Background Image

✨ AI Background Prompt

🌐 Custom Background URL

📚 Background Library

📐 Background Fit

🤖 Automation Settings

📬 User Message Queue

When enabled, user messages queue instead of sending immediately while the AI is responding.

🍃 Ambient Mode

The AI will speak unprompted after periods of silence.

⏱️ Ambient Trigger Delay (seconds)

Trigger after: 10s

⚡ Ambient Preload

Pre-fetch the next ambient comment in the background for instant response.

⚙️ Preferences

🪄 Always show Settings on page load

If enabled, the settings panel opens on every load. Otherwise, it remembers your last open/closed state.

🧬 Load multiple models at once

When enabled, selecting a model adds it without removing existing ones.

🐞 Debug Settings

🧰 Enable Debug Panel

📜 Auto-scroll Log

💬 Show Live2d Debug Logs

🧠 Show AI Debug Logs

🔊 Show TTS Debug Logs

🔌 Offline Mode

⏱️ Offline Duration (seconds)

Reset to Online in: 300s

📄 Show Chat Context in Debug

🚫 Disable automatic Offline Mode

When enabled, the app will never switch itself into Offline Mode automatically after connection errors.

🔗 Links

🏠 Homepage 📖 Moltbook ▶️ Youtube 🐱 GitHub 📚 DeepWiki 📊 Kaggle 📰 Blog 🎮 itch.io ▶️ Sora 🔗 waifuai.sol 🤗 Hugging Face ☁️ Bluesky 💸 Donate (PayPal) 🌐 Websim 💵 Cash App 🎵 TikTok 🐦 Twitter/X 🌐 OpenRouter