TL;DR

  • Rigsmith는 .glb 파일에 스켈레톤 배치, 스키닝, 포즈 설정과 키프레임 작업을 적용하고 텍스트 프롬프트로 동작을 생성하는 3D 리깅·애니메이션 도구임.
  • 수동 조인트 배치와 바이페드·쿼드루페드·조류 신체 계획 맞춤, 관절 제한, 자동 스킨 가중치와 페인팅을 제공함.
  • 타임라인, 반복 재생, 재생 속도, 애디티브 레이어, 자동 키프레임, 저장 포즈와 트위닝으로 애니메이션을 편집함.
  • Vulkan을 통해 GPU에서 NVIDIA의 Kimodo 동작 모델을 실행하며, macOS·Windows·Linux에서 Python이나 CUDA 설치 없이 텍스트-투-모션을 사용할 수 있음.
  • 내장 MCP 서버를 통해 Claude 같은 AI 에이전트가 리깅·포즈·애니메이션 작업을 함께 수행하며, 결과는 같은 파일에 저장됨.

Rigsmith

  • .glb 파일을 열어 스켈레톤을 배치하고, 스키닝을 적용한 뒤 포즈와 키프레임을 설정하거나 텍스트 프롬프트로 동작을 생성함.
  • 모든 작업 결과를 같은 파일에 저장함.
  • Vulkan을 사용해 macOS, Windows, Linux에서 실행됨.

다운로드

  • 최신 빌드는 Releases에서 받을 수 있음.
  • Linux: Rigsmith-<version>-x86_64.AppImage 파일을 실행 가능 상태로 만든 뒤(chmod +x) 더블 클릭해 실행함.
  • Windows: Rigsmith-<version>-windows-x64.zip 파일의 압축을 원하는 위치에 풀고 rigsmith.exe를 실행하는 포터블 방식임.
  • macOS 26 이상(Apple Silicon): Rigsmith-<version>-macos-arm64.dmg 파일에서 Rigsmith를 Applications로 드래그함. 앱은 공증되지 않았으므로 최초 실행 시 마우스 오른쪽 버튼을 클릭하고 열기를 선택해야 함.
  • 최초 실행 시 내장 애니메이션을 Documents/Rigsmith/animations에 복사함. 해당 애니메이션은 에셋 브라우저에 표시되며, 시작 시 열리는 위치이기도 함.
  • Windows에서 rigsmith.exe가 실행되지 않으면 Microsoft Visual C++ Redistributable을 설치해야 함.

기능

  • 리깅: 조인트를 직접 배치하거나 바이페드, 쿼드루페드, 조류 신체 계획을 메시 모양에 맞춤.
  • 관절 제한: 포즈 설정 시 관절이 자연스러운 가동 범위 안에 있도록 유지함.
  • 스킨 가중치: 간단한 자동 가중치를 제공하며, 가중치를 확인하고 페인팅할 수 있음.
  • 애니메이션 플레이어: 반복 재생, 재생 속도 조절, 애디티브 레이어를 지원하는 타임라인임.
  • 에셋 브라우저: 검색 가능한 .glb 클립·신체 계획 폴더와 시작용 내장 라이브러리를 제공함.
  • 포즈와 키프레임: 포즈 키 설정, 자동 키프레임, 저장 포즈, 포즈 사이의 트위닝을 제공함.
  • Kimodo를 사용한 텍스트-투-모션을 제공함.
  • AI 에이전트 연동: 내장 MCP 서버를 통해 Claude 같은 에이전트가 리깅, 포즈 설정, 애니메이션 작업을 함께 수행함.

텍스트-투-모션(Kimodo)

  • Rigsmith는 Vulkan을 통해 GPU에서 NVIDIA의 Kimodo 동작 모델을 실행하므로 macOS, Windows, Linux에서 텍스트-투-모션을 사용할 수 있음.
  • 설치해야 하는 항목은 모델 파일뿐이며 Python이나 CUDA는 필요하지 않음.
  • Hugging Face에서 가중치를 내려받음: 텍스트 인코더는 LocalAI-io/Llama-3-Kimodo-GGML의 Llama-3-Kimodo-*.gguf 파일과 tokenizer.gguf이며, 동작 모델은 LocalAI-io/Kimodo-SOMA-RP-v1.1-GGML임. model.safetensors가 들어 있는 NVIDIA 원본 폴더 nvidia/Kimodo-SOMA-RP-v1.1도 사용할 수 있음.
  • 파일을 원하는 폴더에 넣음. 예시는 ~/models/kimodo/임.
  • Rigsmith에서 File › Settings › AI를 열고 텍스트 모델 .gguf 파일을 선택한 다음 동작 모델의 .gguf 파일 또는 NVIDIA 폴더를 선택함. 토크나이저는 텍스트 모델 파일과 같은 위치에 있지 않은 경우에만 지정함.
  • Generate 탭을 열어 동작을 설명하고 생성을 실행함.
  • 가중치에는 각각 별도의 라이선스가 적용됨: NVIDIA Open Model License와 Llama 3 라이선스임.

AI 에이전트와 Rigsmith 사용(MCP)

  • Rigsmith가 열려 있는 동안 MCP 클라이언트에 도구를 제공함. 기본 주소는 http://127.0.0.1:8808/mcp이며, 기본 설정에서는 로컬 머신에서만 접근할 수 있음.
  • File › Settings를 열면 MCP 섹션에서 서버 주소를 확인할 수 있음.
  • Copy client config를 클릭하고 복사한 설정을 에이전트의 MCP 설정에 붙여 넣음.
  • 해당 설정에서 포트를 변경할 수 있으며 변경 사항은 즉시 적용됨. 포트를 0으로 설정하면 서버가 꺼짐.

소스에서 빌드

  • c3c 0.8.3, 샘플 모델용 Git LFS, Vulkan 드라이버가 필요함. Windows와 Linux는 시스템 드라이버를 사용하며, macOS에서는 setup.sh가 드라이버를 가져옴.
  • 저장소를 재귀적으로 복제하고 Git LFS 파일을 가져온 뒤 libs/three/setup.sh를 실행함. 이 스크립트는 서브모듈과 macOS Vulkan 드라이버를 설정함.
  • c3c build rigsmith로 빌드한 뒤 ./build/rigsmith assets/animations/humanoid.glb로 실행함.
  • 테스트: c3c test --test-noleak은 빠른 테스트이며, c3c test는 메모리 누수 검사도 수행함.
  • 패키징: 빌드 후 packaging/package-{macos,linux,windows}.sh 스크립트로 릴리스 파일을 생성함. v* 태그를 푸시하면 GitHub Actions가 모든 플랫폼의 빌드를 생성함.
  • 소스 저장소: https://github.com/tonis2/rigsmith.git

라이선스

  • 자세한 내용은 LICENSE를 참조함.