shinshin86/mesh-avatar-studio

选用指南

AI 根据 README 整理 · 2026/10/16 22:22:02

适用场景

适用于将插画转换为可动画头像，用于直播、视频会议或虚拟形象展示。

查看 README 依据

and accepts archives up to 128 MiB. Without the source image, the imported avatar can play but cannot be edited or rebuilt. Omitting the source does not remove the built images. See the [avatar format](docs/format.md) for the file contents. ## Live and streaming  Open your project in the editor and choose **Live**. Start the camera, face forward with relaxed eyes and a closed mouth, then choose **Calibrate**. You can adjust mirroring, sensitivity and smoothing, or enable microphone lip sync. Camera video and microphone

The camera is optional: with only the microphone on, the avatar keeps its idle motion and your voice moves the mouth. To appear as the avatar in Zoom, Google Meet and similar apps, use OBS's Virtual Camera ([steps](docs/reference.md#video-calls)). Stream view options, troubleshooting and privacy details are in the [reference](docs/reference.md#live-and-streaming). ### Without installing anything The [Player](https://shinshin86.github.io/mesh-avatar-studio/play/) runs face tracking, microphone lip sync, expressions and lighting entirely in the browser. Open the sample or

使用方式

通过命令行启动本地编辑器，使用编码代理（如 Claude Code 或 Codex）创建头像，并在编辑器中拖拽调整。

查看 README 依据

## Try the sample Requires Node.js 22.17+. ```sh npm install npm run dev ``` Open the URL printed in the terminal (for example `http://127.0.0.1:5173/`). The editor opens the bundled sample, Miko in a qipao. Pick a part on the left, drag its dots on the image and watch the preview on the right. The sample is read-only; when you change it, choose **Copy and keep editing** to continue in your own copy. ### Using Windows Use `git clone` to download the repository when possible. If you use a ZIP, open its Properties in File Explorer and select **Unblock**, if shown, before extracting it.

coding agent (Claude Code or Codex) working in this repository; steps 2 and 3 happen in the editor. ### 1. Ask your agent to create the avatar Open Claude Code or Codex in this repository folder and give it your illustration: > Create an avatar from this image following docs/agent-guide.md: `/path/to/your-image.png` The agent follows [the agent guide](docs/agent-guide.md): it checks how accurately it reads coordinates, places the rig on zoomed grids, cuts the image into layers and reviews the avatar in fixed poses. The project is saved in `projects/<name>/`, which is never committed.

部署要求

需要 Node.js 22.17 或更高版本。

查看 README 依据

## Try the sample Requires Node.js 22.17+. ```sh npm install npm run dev ``` Open the URL printed in the terminal (for example `http://127.0.0.1:5173/`). The editor opens the bundled sample, Miko in a qipao. Pick a part on the left, drag its dots on the image and watch the preview on the right. The sample is read-only; when you change it, choose **Copy and keep editing** to continue in your own copy. ### Using Windows Use `git clone` to download the repository when possible. If you use a ZIP, open its Properties in File Explorer and select **Unblock**, if shown, before extracting it.

已知限制

导入的 .mavatar 文件最大 128 MiB；无源图像时无法编辑或重建。

查看 README 依据

and accepts archives up to 128 MiB. Without the source image, the imported avatar can play but cannot be edited or rebuilt. Omitting the source does not remove the built images. See the [avatar format](docs/format.md) for the file contents. ## Live and streaming  Open your project in the editor and choose **Live**. Start the camera, face forward with relaxed eyes and a closed mouth, then choose **Calibrate**. You can adjust mirroring, sensitivity and smoothing, or enable microphone lip sync. Camera video and microphone