shinshin86/mesh-avatar-studio

어떤 프로젝트인가요?

핵심 기능

• 01이미지 한 장으로 눈 깜빡임, 말하기, 고개 돌리기, 호흡, 머리카락 흔들림을 애니메이션으로 구현합니다.
• 02코딩 에이전트가 일러스트에서 리그와 레이어를 만들 수 있습니다.
• 03드래그 가능한 제어점과 라이브 미리보기를 제공하는 로컬 에디터를 제공합니다.
• 04포즈 테스트와 모음 립싱크 테스트를 지원합니다.
• 05아바타를 하나의 .mavatar 파일로 내보내고 가져올 수 있습니다.
• 06투명한 Browser Source를 통해 얼굴 추적 움직임을 OBS로 전송합니다.

활용 사례

• 직접 그린 캐릭터 아트로 라이브 스트리밍용 VTuber 스타일 아바타를 만들 때.
• 3D 모델 없이 OBS 장면에 애니메이션이 적용된 말하는 발표자를 추가할 때.
• 완성된 2D 아바타를 휴대하기 편한 파일 하나로 다른 사람과 공유할 때.
• 아무것도 설치하지 않고 브라우저에서 얼굴 추적 아바타 움직임을 시험할 때.

빠른 시작

1. 1

   Node.js 22.17+와 Git을 설치합니다

2. 2

   setup 명령어로 프로젝트를 생성합니다

   npx create-mesh-avatar-studio
3. 3

   프로젝트 폴더로 이동합니다

   cd mesh-avatar-studio
4. 4

   에디터를 실행하고 표시된 URL을 엽니다

   npm run dev

사용 전 알아둘 점

• !직접 그린 일러스트로 아바타를 만들려면 Claude Code나 Codex와 같은 코딩 에이전트가 필요합니다.
• !라이브 스트리밍과 에디터를 사용하려면 로컬 개발 서버(npm run dev)가 실행 중이어야 합니다.
• !Windows에서는 다른 계정이나 샌드박스 에이전트가 만든 폴더를 권한 변경 없이는 읽을 수 없는 경우가 있습니다.

토픽

자주 묻는 질문

mesh-avatar-studio은(는) 무엇인가요?

일러스트 한 장을 코딩 에이전트가 준비하고 로컬 에디터에서 다듬는, 눈을 깜빡이고 말하며 흔들리는 2D 메시 아바타로 변환합니다. Mesh Avatar Studio는 보통 투명 배경의 정면 상반신 PNG 일러스트 한 장을 눈을 깜빡이고 말하고, 고개를 돌리고, 숨을 쉬며 머리카락이 흔들리는 2D 아바타로 변환합니다. Claude Code나 Codex 같은 코딩 에이전트가 프로젝트의 에이전트 가이드를 따라 이미지에서 리그와 레이어를 준비하고, 라이브 미리보기를 제공하는 로컬 에디터에서 제어점을 드래그해 위치를 수정하고 레이어를 다시 만들 수 있습니다.

mesh-avatar-studio은(는) 무료로 사용할 수 있나요? 라이선스는 무엇인가요?

mesh-avatar-studio은(는) MIT 라이선스의 오픈소스입니다. 상업용 제품에 사용하기 전에 라이선스 조건을 확인하세요.

mesh-avatar-studio은(는) 아직 유지보수되고 있나요?

활발히 유지보수 중. mesh-avatar-studio의 마지막 커밋은 2026년 10월 19일입니다.

mesh-avatar-studio은(는) 어디에 사용할 수 있나요?

직접 그린 캐릭터 아트로 라이브 스트리밍용 VTuber 스타일 아바타를 만들 때. 3D 모델 없이 OBS 장면에 애니메이션이 적용된 말하는 발표자를 추가할 때. 완성된 2D 아바타를 휴대하기 편한 파일 하나로 다른 사람과 공유할 때. 아무것도 설치하지 않고 브라우저에서 얼굴 추적 아바타 움직임을 시험할 때.

mesh-avatar-studio는 어떻게 설치하나요?

Node.js 22.17+와 Git을 설치합니다 setup 명령어로 프로젝트를 생성합니다: npx create-mesh-avatar-studio 프로젝트 폴더로 이동합니다: cd mesh-avatar-studio 에디터를 실행하고 표시된 URL을 엽니다: npm run dev

mesh-avatar-studio은(는) 어디서 받을 수 있나요?

소스 코드와 설치 방법은 GitHub에 있습니다: https://github.com/shinshin86/mesh-avatar-studio