cute-fat-fish-pet

蓝毛小女仆 · 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 dsh-pet@0.3.0 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. 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: In short: rename what is visible — plus the plugin package name, once — but never touch the identifiers that hold user data. That is what makes upgrading from 1.0.0 a no-op for the user.

The same list is in NOTICE.md (section 5), and the reasoning behind it is in docs/architecture-roadmap.zh-CN.md. What she can doShe moves on her own — 106 hand-drawn transparent animations (VP9-alpha webm, composited onto your wallpaper with a screen blend). Idle breathing, looking around, walking to random spots, random small gestures. Animation weights and frequency are configurable.She talks with you — click her to open the chat. Local models through Ollama or any OpenAI-compatible endpoint; the console has three modes: Local, Auto (best available) and Online.She can watch your screen (optional, switchable) — a screenshot every so often is handed to a vision model and she comments on it. With no vision model configured this path stays off instead of sending a random image.She mutters and speaks up — she fills quiet moments on her own, and can be driven by work state (task started / finished / failed).She can do things for you (your call) — open an app, a file, a folder or a URL; screen recording goes to OBS or to whatever software you pick, saved wherever you pick. Three permission switches turn this off completely.Voice — speech input runs fully offline inside the package (sher