Waifu Sprites Documentation

An animated anime companion that reacts to your chat, right in the browser.

What it is

Waifu Sprites is a companion made of short video clips instead of a 3D or Live2D model. Every clip is a few seconds of hand-picked animation that loops seamlessly, so she always looks alive: idle while you read, listening while you type, thinking while the reply is on its way, and then reacting to what she says.

There are 24 clips with alternates: 12 activity states and 12 emotions. The AI tags each reply with an emotion, and the matching clip plays as soon as the first words arrive. It's free, needs no sign-up, and works on phones.

Pictures

Ask her for a selfie, a drawing or a picture of anything, in any language, and she paints it while she replies: she looks busy planning while it's drawn, then triumphant when it lands in the chat. You can also type /image followed by a description, with portrait, square or landscape at the end to pick the shape. Pictures are safe-for-work only and are saved with the chat.

Talk to her

She reads her replies aloud with TikTok voices: pick from soft female voices, Japanese and Korean voices, characters like Stitch and Ghost Face, or singing voices. When she answers in another language, a voice for that language reads it. The speaker button at the top mutes her.

Hold the mic button and speak, or tap it once to start and again to stop. She listens while you talk, and your words are transcribed and sent, in whatever language you speak. Turn off "Send right after speaking" in Settings to check the text before it goes.

Memory and personality

She remembers. Tell her about yourself under About you in Settings and every chat starts with it. When a chat grows past the messages she keeps word for word, the oldest are folded into a summary she carries forward, and a marker in the chat shows where. You can read and edit that summary, summarize on demand, and see exactly what she's sent.

Pick a personality (Aurora, tsundere, study buddy, a plain assistant or your own) and add extra instructions on top. She knows the date and time, and your battery level if you allow it. She replies in your language, or one you pick, with romaji under Japanese and Korean replies if you like.

Turn on She talks when you're quiet and she speaks up after a pause you choose. Messages you send while she's replying wait in a queue. Chats name themselves, and each message can be read aloud again, copied or deleted. There's also an anime radio, a clock and a chat export.

States and emotions

StateWhen it plays
idleNothing happening
listeningYou're typing
thinkingWaiting for the reply
speakingReply with no clear emotion
error / alertThe AI service failed
sleepingNo activity for a few minutes
Emotions
happy, laughing, love, amazed
curious, planning, triumphant
empathetic, sorry, confused
annoyed, overwhelmed

The other states (typing, searching, calculating, fixing, success) come from the Hermes Agent plugin, where they follow what the agent is doing.

Why she never repeats herself

Emotions are picked with RANSOC. Each emotion carries a weight that drops when it plays and recovers while others play. The same emotion never plays twice in a row; when the reply asks for the one just shown, a similar emotion plays instead, so happy may become love or laughing. Each clip also has an alternate take, and the player alternates between them.

AI and privacy

Use it with Hermes Agent

The same sprites run as a dashboard plugin for Hermes Agent, where the clip follows the agent's work: typing during file edits, searching during web lookups, calculating, fixing and celebrating success. Clone waifuai/waifu-sprites into ~/.hermes/plugins and rescan plugins from the dashboard.

Related