git404hub

what is purupurupngtuber fr?

rotejin/purupurupngtuber — explained in plain English

Analysis updated 2026-05-18

114JavaScriptAudience · vibe coderComplexity · 2/5LicenseSetup · moderate

tl;dr

A local browser app that turns expression PNGs plus separate front and back hair layers into a swaying animated streaming avatar.

vibe map

mindmap
  root((PuruPuru PNGTuber))
    What it does
      Hair sway animation
      Expression swapping
      Face and mic tracking
    Tech stack
      JavaScript
      Python
      MediaPipe
    Use cases
      Vtuber streaming
      AI agent avatar setup
      OBS overlay
    Audience
      Streamers
      Vibe coders
    Setup
      Python local server
      Prepare aligned PNGs
      Ask coding agent to configure

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Turn a set of expression PNGs and hair layers into an animated PNGTuber avatar for streaming.

VIBE 2

Ask a coding agent to auto configure a new character's files and anchor point settings from raw art.

VIBE 3

Track your face or mouth movement locally to drive blinking, talking, and head turning in real time.

VIBE 4

Export a finished character as a single portable file to back up or move between computers.

what's the stack?

JavaScriptPythonMediaPipe

how it stacks up fr

rotejin/purupurupngtuberyyx990803/release-tagcupidbity/cupid-music-player
Stars114113112
LanguageJavaScriptJavaScriptJavaScript
Last pushed2023-12-14
MaintenanceDormant
Setup difficultymoderateeasyeasy
Complexity2/52/52/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires preparing correctly aligned transparent PNG layers before a character can be set up.

The software and docs can be used freely including commercially under Apache 2.0, but the bundled demo avatar images and visuals follow a separate, more restrictive asset license.

in plain english

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.

prompts (copy fr)

prompt 1
Use the PNG art in this folder to add a new PuruPuru PNGTuber character, following the project's asset naming rules.
prompt 2
Help me run the local server for PuruPuru PNGTuber on macOS and open it in Chrome.
prompt 3
Explain what fields default-settings.json needs for face center, eyes, mouth, and hair anchor lines.
prompt 4
Show me how to export my finished avatar as a .purupuru package for backup.

Frequently asked questions

what is purupurupngtuber fr?

A local browser app that turns expression PNGs plus separate front and back hair layers into a swaying animated streaming avatar.

What language is purupurupngtuber written in?

Mainly JavaScript. The stack also includes JavaScript, Python, MediaPipe.

What license does purupurupngtuber use?

The software and docs can be used freely including commercially under Apache 2.0, but the bundled demo avatar images and visuals follow a separate, more restrictive asset license.

How hard is purupurupngtuber to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is purupurupngtuber for?

Mainly vibe coder.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.