cyanfish-x/dsh-live2d-pets
Live2D pet plugin for DeepSeek Harness: Agent state mirror + interactive companion, built-in loose license default model / Live2D pet plugin: agent state mirror + intera
dsh-live2d-pets is a Live2D desk pet for DeepSeek Harness: it tilts its head when you think, celebrates when you finish, and you can pet it. Features: 5 curated model presets (Hiyori / Haru / Mao / Mark / Natori) plus custom entries with animation mapping; state mirroring of agent thinking / idle / error / done / waiting-for-approval via motion and bubbles (SSE push); six built-in persona tones (tsundere / genki / airhead / kuudere / gentle / yandere) with custom personas via JSONC hot reload; part-based tap reactions, mouse-follow, free drag docking, and task-done celebration; a DSH Settings Pet config panel (enable, size, FPS, persona, models, developer options) that applies immediately; and stay-out-of-the-way behavior (bottom-right default, small, draggable, hideable, pause rendering on hidden tab, FPS cap, static fallback on low end).
Install
dsh plugin --profile web add dsh-live2d-petsInstall with dsh plugin --profile web add dsh-live2d-pets (the plugin is enabled by default after install), then start DSH with dsh web and open the browser — a default 160px pet appears at the bottom-right. The README also offers an agent-prompt install path that has the agent run the install and list commands and report the result.
Compatibility
DeepSeek Harness Web (dsh web) bundle plugin. Model loading supports https/http .model3.json URLs and absolute local paths served by the plugin Host through a same-origin route; settings persist to ~/.dsh/settings.yaml, custom personas to ~/.dsh/live2d-pet/personas.jsonc, custom models to ~/.dsh/live2d-pet/custom-models.jsonc; state pushed via same-origin SSE /api/live2d-pet/events.
Details
- Repo: cyanfish-x/dsh-live2d-pets
- Category: Entertainment & Lifestyle
- Stars: 10
- Version: npm package dsh-live2d-pets 0.2.2 (registry-verified 2026-08-23); plugin code MIT; model list URL-only with per-entry license; built-in sample models under Live2D Sample Model Terms
- Last push: 2026-08-16
- First seen: 2026-08-14
Recent updates
The current README documents model loading, state mirroring, personas, companionship interactions, the settings panel, quick-start (agent prompt or manual install), interaction details, and licensing (plugin MIT, sample models under Live2D Sample Model Terms).
FAQ
- How do I install it?
- dsh plugin --profile web add dsh-live2d-pets, then start dsh web — a default 160px pet (Hiyori) appears at the bottom-right; first load needs network for the model.
- Can I use my own Live2D model?
- Yes — any .model3.json over https/http or an absolute local path, with optional animation mapping binding native motion groups to pet states and touch interactions.
- Does the pet slow down my machine?
- It is designed to stay out of the way: FPS cap, pause rendering when the tab is hidden, static avatar fallback on low end, and a hideable/draggable small default size.
Alternatives
crafter-station/petdex · liyupi/dsh-kun-like-pet · HuanLinOTO/dsh-plugin-pet-rs