VRMMetalKit · Open-source Swift package

Bring an avatar
into your Apple app.

Render and animate VRM characters with Swift and Metal. Start with a first render, then add expressions, animation, and interaction.

Native Apple development · Source code under Apache 2.0

From a model to a render.

  1. In Xcode, choose File → Add Package Dependencies and enter the repository URL below.
  2. Select the release compatible with your project and add the VRMMetalKit library product to your app target.
  3. Follow the documentation’s getting-started example with a VRM asset you have permission to use.
https://github.com/arkavo-org/VRMMetalKit

For a command-line render, clone the repository, select a release, and run its documented rendering tool from that checkout:

swift run VRMRender model.vrm output.png

Replace model.vrm with your model’s path. A successful run writes a PNG to output.png.

Choose the capabilities you need.

Capability Documented support
Avatars VRM 1.0, with a VRM 0.x compatibility path.
Appearance MToon shading, expressions, and spring physics.
Animation VRMA loading, retargeting, looping, and speed control.
Asset rendering The sibling GLTFMetalKit product handles glTF 2.0 assets.

Check the version before integrating.

The current main-branch package specifies Swift tools 6.3 and macOS, iOS, or visionOS 26. Requirements may differ between releases. Check the package manifest and release notes for the version you choose.

Rendering requires a compatible Metal device and the platform toolchain. The published documentation covers integration and platform-specific setup.

Code and assets have separate licenses.

Source code is licensed under Apache 2.0. Check the repository’s licensing section and each avatar’s permissions before redistributing content.

Report an integration issue with your package version, platform, and a minimal reproduction.

Documentation checked September 19, 2026.