Iven Pet 🐾 · 3D Chibi Desktop Pet

A Shimeji-style Windows desktop pet built from AI-generated 3D character sheets. She walks along your taskbar, stands on top of your application windows, climbs down when you close them — and does a little clapperboard cheer when you double-click her.

English | 简体中文

Part of the IvenKooLab IP lab series. Want to turn your character into a desktop pet? Follow docs/SOP-IP角色桌宠化.md (Chinese, with checklist).

Features

• Real walk cycle from AI-generated walk-sheet frames (left/right facing)
• Windows are platforms — she walks on top of your app windows, turns at edges (or falls off), and drops when you close the window
• Idle breathing · grab struggle · gravity fall · landing squash · sleep
• Interactions: click = bounce, double-click = happy, right-click menu (clapperboard cheer / 360° spin / fast walk / shy / sleep)
• Zero third-party dependencies at runtime — pure Python standard library (tkinter)

Quick Start

Option A — ready-to-run: grab IvenPet.exe (≈11 MB) from Releases, drop it on your desktop, double-click.

Option B — from source:

python pet.py        # Windows + Python 3.8+ (tkinter bundled), nothing else to install

Right-click the pet for the menu; drag her anywhere; double-click her for a reaction. Close her via right-click menu → 退出 (Exit).

Build Your Own IP Pet

The whole pipeline is documented as a step-by-step SOP: generate character sheets with your favorite AI image tool → AI matting → animation frame synthesis → automated QA → PyInstaller packaging.

See docs/SOP-IP角色桌宠化.md and the new-IP checklist inside.

tools\build_exe.bat   # rebuilds dist\IvenPet.exe (needs pyinstaller)

Repository Layout

pet.py                  # runtime: state machine + window-as-platform + single instance
frames3d/               # 33 animation frames (GIF, magenta-key transparency)
tools/make_frames3d.py  # asset pipeline: AI matting → slicing → frame synthesis
tools/qa_frames.py      # numeric QA: fragments / holes / size consistency
tools/qa_diff.py        # pixel regression: final frames vs source cuts
tools/smoke.py          # state-machine smoke test with screenshots
docs/                   # SOP + asset pipeline documentation
assets/src/             # AI-generated character sheets (source of truth)

License

MIT · Character art generated with AI, copyright IvenKooLab