CHARACTERS ARE DATA, NOT CODE

One desktop companion.
Infinite personalities.

Waifu Studio is a desktop AI companion platform where every character — voice, wake word, personality, colour theme, response lines — is yours to forge. Pick a legend below and watch this page re-theme itself, exactly like the app does.

⚡

Reia

The Lightning Sovereign
"You called. I'm listening — make it worth my time."
wake word: "hey reia"
— Select your companion —

Six bundled presets. Every one editable. Or forge your own from a blank sheet.

Get started See the Forge
See it in motion

The Studio, running

Dashboard, live chat, gallery re-theming, the Forge, settings, and mini mode — a real capture of the desktop app driving every screen.

The Studio

A SaaS-grade shell for a desktop companion

Sidebar navigation, live stat tiles, and a design system driven entirely by the active character's five-colour palette. Switch companions and the whole app re-themes.

▦ Dashboard

Command center

Hero card with the active companion's greeting, live counts for memories and to-dos, and one-click quick actions.

💬 Chat

Full-size conversation

Animated avatar with per-state effects, chat feed, mic capture, and 50+ parsed intents from timers to system control.

👥 Characters

The gallery

Card grid of your whole roster — activate, edit, duplicate, or retire a companion in one click.

✨ Forge

The character editor

Identity, soul, theme, voice, greetings, and response-line overrides — every field of a companion, editable.

⚙ Settings

GUI onboarding

Gemini and Ollama backends, TTS and Whisper options — no more CLI wizard on first run.

🗗 Mini mode

The classic floating widget

Always-on-top translucent companion window, one shortcut away (Ctrl+M), skinned to the active character.

The Forge

Every companion is a JSON file you can read

Characters persist as portable JSON — shareable, versionable, remixable. Override any built-in response line in their voice; placeholders substitute at runtime.

config / characters / reia.json
{
  "name": "Reia",
  "archetype": "tsundere",
  "wake_word": "hey reia",
  "palette": { "primary": "#A855F7", … },
  "lines": {
    "open_app": "Opening {target}. Try not to waste too much time."
  }
}
Quick start

Running in three commands

git clone https://github.com/Arnav1771/Ai-waifu.git
cd Ai-waifu
pip install -r requirements.txt
python main.py
1 · Add a free Gemini key. First run opens Settings — paste a key from aistudio.google.com.
2 · Pick a companion. Activate one of the legendary six from the gallery.
3 · Or forge your own. Name, soul, palette, voice, wake word — save and activate.