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.
- In Xcode, choose File → Add Package Dependencies and enter the repository URL below.
-
Select the release compatible with your project and add the
VRMMetalKitlibrary product to your app target. - 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.