rotejin/purupurupngtuber

PuruPuru PNGTuber is a local browser app for building animated PNGTuber avatars, the flat image based streaming characters popular with virtual streamers. It builds on the usual PNGTuber approach of swapping expression images for different eye and mouth states, but adds two extra layers, front hair and back hair, so the hair can sway and move independently of the face. The intended workflow leans on AI coding agents. You prepare a set of aligned transparent PNG images for a character, including the expression variations, front hair, and back hair, and then ask a coding agent such as Codex or Claude Code to organize the files, rename them correctly, and generate the character's initial settings file with face, eye, mouth, and hair anchor points. After that setup step, you fine tune the character visually inside the browser, adjusting expressions, head turning, hair sway, and any extra items like ribbons or hairpins. Once a character is set up, it can talk based on microphone volume or a demo mode, blink automatically, and follow the mouse or track your face through the camera, with face tracking capped at 15 frames per second on the CPU by default to avoid heavy GPU use. Finished characters can be exported as a single portable file that bundles the images and all adjustment settings together, so a character can be backed up or moved to another computer without keeping track of the original image folder. To run it, you need Python 3.10 or later and a Chromium based browser, and you start a local server with a provided script rather than opening the app's HTML file directly. Camera and microphone data are processed locally in the browser. The software and documentation are released under the Apache 2.0 license, while the bundled demo avatar images and other visual assets are covered by a separate asset license.