Repolode
Submit
shinshin86

shinshin86/mesh-avatar-studio

Turns one illustration into an animated 2D mesh avatar that blinks, talks and sways, prepared by a coding agent and tuned in a local editor.

Open-source alternative to:VTube Studio

View on GitHubWebsite
Stars
860
Forks
93
Open issues
2
Last commit
yesterday

What is it?

Mesh Avatar Studio takes a single illustration, typically a front-facing head-and-shoulders PNG with a transparent background, and turns it into a 2D avatar that blinks, talks, turns its head, breathes and sways its hair. A coding agent such as Claude Code or Codex prepares the rig and layers from the image by following the project's agent guide, and a local editor with a live preview lets you drag control points to correct placement and rebuild layers.

The editor includes pose testing for head turns and eye closure, a lip-sync check for vowel mouth shapes, and optional drawn eye and mouth variants generated with an image tool. Finished avatars can be exported as a single .mavatar file and imported again, with the source image included if you want to keep editing.

For streaming, the Live page tracks your face through the camera and can use the microphone for lip sync, then sends the motion to a transparent stream view that can be added to OBS as a Browser Source. A browser-only Player runs tracking and lip sync without installing anything.

Key features

  • 01Animates blinking, talking, head turns, breathing and hair sway from one image.
  • 02Lets a coding agent build the rig and layers from your illustration.
  • 03Provides a local editor with draggable control points and live preview.
  • 04Offers pose tests and a vowel lip-sync check.
  • 05Exports and imports avatars as a single .mavatar file.
  • 06Streams face-tracked motion to OBS through a transparent Browser Source.

Use cases

  • Creating a VTuber-style avatar for livestreams from your own character art.
  • Adding an animated talking presenter to OBS scenes without a 3D model.
  • Sharing a finished 2D avatar with others as one portable file.
  • Trying out face-tracked avatar motion in the browser without installing anything.

Quick start

  1. 1

    Install Node.js 22.17+ and Git

  2. 2

    Create the project with the setup command

    npx create-mesh-avatar-studio
  3. 3

    Enter the project folder

    cd mesh-avatar-studio
  4. 4

    Start the editor and open the URL it prints

    npm run dev

Things to know

  • Making an avatar from your own illustration requires a coding agent such as Claude Code or Codex.
  • Live streaming and the editor need the local development server (npm run dev) running.
  • On Windows, folders created by another account or a sandboxed agent may be unreadable without changing permissions.

Topics

#2d-animation#avatar#mesh-deformation#webgl#vtuber#typescript#live-streaming#claude-code#codex

FAQ

What is mesh-avatar-studio?
Turns one illustration into an animated 2D mesh avatar that blinks, talks and sways, prepared by a coding agent and tuned in a local editor. Mesh Avatar Studio takes a single illustration, typically a front-facing head-and-shoulders PNG with a transparent background, and turns it into a 2D avatar that blinks, talks, turns its head, breathes and sways its hair. A coding agent such as Claude Code or Codex prepares the rig and layers from the image by following the project's agent guide, and a local editor with a live preview lets you drag control points to correct placement and rebuild layers.
Is mesh-avatar-studio free to use? What license does it have?
mesh-avatar-studio is open source under the MIT license. Check the license terms before using it in commercial products.
Is mesh-avatar-studio still maintained?
Actively maintained. The last commit to mesh-avatar-studio was on Oct 19, 2026.
What can I use mesh-avatar-studio for?
Creating a VTuber-style avatar for livestreams from your own character art. Adding an animated talking presenter to OBS scenes without a 3D model. Sharing a finished 2D avatar with others as one portable file. Trying out face-tracked avatar motion in the browser without installing anything.
How do I install mesh-avatar-studio?
Install Node.js 22.17+ and Git Create the project with the setup command: npx create-mesh-avatar-studio Enter the project folder: cd mesh-avatar-studio Start the editor and open the URL it prints: npm run dev
Where can I get mesh-avatar-studio?
The source code and installation instructions are on GitHub: https://github.com/shinshin86/mesh-avatar-studio

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects