12we21/cute-fat-fish-pet
A transparent always-on-top desktop pet with 106 hand-drawn animations that idles, wanders and reacts, chats through a local or OpenAI-compatible model, and can open apps, files or pages when asked.
The pet engine is the published dsh-pet@0.3.0 codebase carried forward in-tree — the README states 232 of its 243 files are byte-identical, 11 were changed on purpose with reasons listed, and three engine files are new, so there is no patching step and src/ is the shipped source. She reacts to clicks and screen content, and on request can open an app, file, folder or web page or start a screen recording. The console offers Local, Auto (best available) and Online model modes, with the online mode taking any OpenAI-compatible endpoint. Installing through the DSH plugin route keeps data under $DSH_HOME/dsh-pet/ rather than %APPDATA%\BlueHairMaid, so it does not collide with a standalone install of the older product.
Install
dsh plugin --profile web add github:12we21/cute-fat-fish-petThe README's install section uses the same github: source with a #path:/src suffix for the src-only package; the plain github: form is what the plugin-route paragraph documents. There is no npm package under this name — the README explains the old name collided with the upstream dsh-pet package, so the plugin package name was changed and the installers keep the legacy display name.
Compatibility
Windows desktop only: the pet window is a separate desktop app that the plugin's host half launches, and state lives under $DSH_HOME/dsh-pet/. Speech needs either Ollama or any OpenAI-compatible endpoint (base URL, key, model name) configured in the console; with no model at all she still idles, wanders and gestures, she just does not talk.
Details
- Repo: 12we21/cute-fat-fish-pet
- Category: Just for Fun
- Stars: 12
- Version: 1.2.3 per README; MIT
Alternatives
swaylq/dsh-digipet · THEWOLFWALKER/dsh-coyote · nzl153/dsh-pet-whale