A desktop AI companion that lives on your screen, watches what you're doing, and has opinions about it.

Teto is a transparent, always-on-top desktop companion built with Electron + React. She sits in the corner of your screen, reacts to what she sees, talks to you when you message her, and generally makes herself at home.

She's powered by Claude for conversation, Fish Audio for her voice, and a small pile of hand-drawn sprites for her expressions.

• Screen awareness — she watches your screen and reacts to what's happening, unprompted
• Voice — synthesized speech via Fish Audio S2, with inline delivery tags for cadence
• Voice input — push-to-talk via mic button or hold Ctrl+Space
• Chat — type to her directly; she maintains conversation context
• Web search — ask her to look something up and she will, using Tavily
• Game mode — enable it and she pays closer attention while you play
• Accessories — put a hat on her
• System tray — she lives in the tray when you close the window; right-click to mute or quit
• Idle animations — she breathes, gets sleepy, yawns when you've left her alone too long

• Node.js 18+
• An Anthropic API key (required)
• A Fish Audio key + reference voice ID (optional — enables her voice)
• An OpenAI API key (optional — enables voice input via Whisper)
• A Tavily API key (optional — enables web search)

npm install
cp .env.example .env
# fill in your keys in .env
npm run dev

npm run package

Produces a portable .exe in release/.

All settings are available in the in-app Settings window (⚙ button, or right-click tray → Settings). Keys entered there are saved locally and take precedence over .env.

• Electron 33 — desktop shell
• React 18 + Vite — renderer
• Claude (Anthropic) — conversation and screen reactions
• Fish Audio S2 — voice synthesis
• OpenAI Whisper — voice transcription
• Tavily — web search

_{the lowest cortisol}