arata-ae/purupurupngtuber

PuruPuru PNGTuber is a local web application for creating animated avatar characters used in live streaming, a format called PNGTubing. Instead of a full 3D virtual avatar, a PNGTuber uses a set of flat PNG images that swap based on whether the streamer is talking, blinking, or moving. This app adds front hair and back hair layers on top of the standard expression images, giving the avatar more visual depth without requiring any 3D software. The app runs in your browser via a local server. You start it with a Python script or a batch file and it opens at a local address. A camera and microphone are needed for the two live-response features: face tracking detects your head position and gaze direction so the avatar mirrors you, and microphone input drives the mouth animation so the avatar appears to talk when you speak. To set up a character you prepare a set of transparent PNG files: six expression images covering combinations of eyes open or closed and mouth closed, half open, or fully open, plus a front hair image and a back hair image. The intended workflow is to ask an AI coding tool like Codex or Claude Code to handle the initial file organization and configuration file creation, then adjust positions and styling manually in the browser editor. An advanced warp editor allows fine-tuning of how the face and hair layers align. The finished avatar displays in OBS, the software most streamers use to compose their video output, via a transparent browser source. Settings and the complete character package can be exported and re-imported as a .purupuru file. Demo avatar files are bundled with the repo so you can test the app immediately after cloning. The software code is licensed under Apache 2.0. The bundled demo artwork has a separate asset license.