蓝毛小女仆 · Blue-Haired Little Maid

A free, open-source desktop pet for Windows: a transparent little maid who lives on your desktop.

She idles, wanders around and does little animations on her own. She can chat with you, take a look at your screen and say something about it — and when you ask her to, she can open an app, a file, a folder or a web page for you, or start a screen recording.

Install · First run · Data & privacy · Build from source · Verify your download · License

English · 中文文档

---

About this project

蓝毛小女仆 (Blue-Haired Little Maid) is an independent desktop-pet project, developed and maintained by Mikolu.

Special thanks to PC2005-cloud, whose dsh-pet 0.3.0 provided the early foundation and the inspiration for this project.

The pet engine in src/ is that codebase, carried forward and maintained in-tree: of the 243 files in the published upstream [email protected] package, 232 are byte-identical here and 11 were changed on purpose (each one listed with sizes and reasons in docs/differences-from-upstream.md), no upstream file was dropped, and three engine files (runtime/electron-helper/obs-ctl.js, stt-worker.mjs, targets.js) are ours. Everything else in this repository — the console, the standalone runner, the build chain, the installer, the docs — is this project's own work.

There is no patching step any more: src/ is the shipped source. Building is just laying the source tree out in release shape and adding the runtimes that are not kept in git.

Product name	蓝毛小女仆 (Blue-Haired Little Maid)
Repository / package / installer name	cute-fat-fish-pet — legacy display name "Cute Fat Fish Pet" / 「可爱大肥鱼桌宠」
Author / maintainer	Mikolu
Version	1.2.3
License	MIT — see LICENSE

On the name. 蓝毛小女仆 is the product's name. The repository and the npm package keep the bare identifier cute-fat-fish-pet, and the installers shipped so far still carry the older display name Cute Fat Fish Pet / 「可爱大肥鱼桌宠」 — renaming those would break existing installs, shortcuts and download links, so they stay as they are. Until the next repack, Windows still shows 「可爱大肥鱼桌宠」 on the desktop shortcut and in Settings → Apps.

Internal identifiers are kept on purpose (BlueHairMaid)

Everything the user can see has been renamed, and so has the DSH plugin package name (it collided with the upstream npm package). Everything else on the inside has not — on purpose:

Internal identifier	Value	What breaks if it is renamed
App folder / APP_ID / uninstall entry	BlueHairMaid	Existing config, data, shortcuts and "Apps & features" entry no longer match — it becomes a second pet
Pet plugin package name (renamed 2026-10-10)	dsh-pet → cute-fat-fish-pet	Nothing user-visible: the data root and route prefix below are hard-coded strings in src/lib/, not derived from the package name, so persona and memory stay put. An already-installed copy just has to be re-added once.
Desktop renderer package	dsh-pet-electron-helper	The pet page's localStorage (position, size, sprite state) is lost and she is put back in the middle of the screen
Brows

…