Desktop Pet

Your AI soul doesn’t have to stay inside a browser tab. With the desktop app, your soul can live on your desktop as a transparent Live2D character — always visible, always present.

What is Desktop Pet Mode?

Desktop Pet mode launches your soul as a transparent overlay window on top of your desktop. The character:

Breathes with idle animation when waiting
Thinks visually when processing events
Speaks with lip-sync when using TTS
Passes through mouse clicks so it never blocks your work

You can also use Live2D characters directly in the main app or web interface — Desktop Pet mode is an optional enhancement for the Electron desktop app.

Requirements

AnySoul desktop app installed (Windows / macOS / Linux)
A Live2D model configured on your agent

Quick Start

1. Set Up Your Live2D Model

If you haven’t already, import a Live2D model for your agent:

Open Agent Settings → Appearance → Live2D Model
Upload your .moc3 model file and textures
Configure basic animation clips

See the Live2D Getting Started guide for detailed instructions.

2. Launch Desktop Pet

There are two ways to activate Desktop Pet mode:

From Agent Settings:

Open Agent Settings → Integrations
Click Desktop Pet Mode

3. Customize

Right-click the pet character to access the context menu:

Option	Description
Scale	Adjust character size (0.8x – 1.5x)
Show Monologue	Display the agent’s inner thoughts above the character
Show Chat	Show recent chat messages near the character
Always on Top	Keep the pet above all other windows
Mouse Passthrough	Toggle whether clicks pass through the pet window
Reset Position	Reset to default position and size

How It Works

Main AnySoul Window
  │
  │  Agent state changes (thinking, speaking, emotion...)
  │
  ▼
IPC Relay (Electron main process)
  │
  │  Forwards state + audio amplitude
  │
  ▼
Pet Overlay Window (transparent BrowserWindow)
  │
  │  PIXI.js + Live2D Cubism SDK
  │  Renders character with real-time animation
  │
  ▼
Desktop — character floats transparently over your workspace

The pet window is a separate Electron BrowserWindow with:

Transparent background (no frame, no chrome)
alwaysOnTop enabled by default
Mouse passthrough on non-interactive areas
Position and scale persisted across sessions

Agent State → Character Animation

The pet character reacts to your agent’s cognitive state:

Agent State	Character Behavior
Idle	Gentle breathing animation
Thinking	Head tilt, eyes looking up
Searching	Eyes scanning side to side
Recalling	Eyes closed briefly, then open
Speaking	Mouth moves with TTS audio (lip-sync)
Saving	Brief sparkle or glow effect

These mappings are configured through the Live2D Animation & Mapping system.

Using Without Desktop Pet Mode

Even without the Electron desktop app, you can use Live2D characters in:

Web app — Live2D character displays in the main chat interface
Immersive mode — Full-screen character view with transparent background
Desktop app (main window) — Character renders alongside chat

Desktop Pet mode is specifically the floating overlay that sits on top of other applications.

Tips

Start small: Use 0.8x scale when first trying, then adjust to your preference
Corner placement: Place the pet in a screen corner where it won’t interfere with your primary workspace
Monologue mode: Enable “Show Monologue” to see what your agent is thinking without switching to the main window
Multi-monitor: Drag the pet to any monitor — position is saved per session

Live2D Getting Started — import and configure a Live2D model
Live2D Animation & Mapping — map agent states to character expressions
Live2D Parameters — fine-tune model parameters
Install Desktop App — download and install the Electron app
AI VTuber — use your character for live streaming
AI Companion — always-on companion use case