| --- |
| license: other |
| license_name: motionsmith-runtime-multiple-third-party-licenses |
| tags: |
| - unreal-engine |
| - animation |
| - motion-generation |
| - nvidia-kimodo |
| - ai-animation |
| - motionsmith |
| --- |
| |
| # MotionSmith Runtime |
|
|
| **MotionSmith Runtime** is the external AI runtime package used by **MotionSmith - AI Animation Studio** for Unreal Engine. |
|
|
| It provides the Python environment, NVIDIA Kimodo components, motion-generation model, LLM2Vec text-encoder adapters, backend workers, and supporting dependencies required by MotionSmith. |
|
|
| This repository is intended for use with the MotionSmith Unreal Engine plugin and is not a standalone application. |
|
|
| ## Runtime Version |
|
|
| **MotionSmith Runtime 1.0.0 — Win64** |
|
|
| Runtime package: |
|
|
| `releases/1.0.0/MotionSmithRuntime-1.0.0-Win64.zip` |
|
|
| SHA-256: |
|
|
| `98acde53cc8c16d2496f5512978f1f5227075930417ebdd9db36ed123abddf03` |
|
|
| ## Installation |
|
|
| The recommended installation method is through MotionSmith inside Unreal Engine. |
|
|
| Open: |
|
|
| **Editor Preferences → Plugins → MotionSmith** |
|
|
| Then use: |
|
|
| **Install MotionSmith Runtime** |
|
|
| MotionSmith downloads this Runtime package, verifies its SHA-256 checksum, installs it to the local MotionSmith Runtime directory, and validates the required components. |
|
|
| Default installation location on Windows: |
|
|
| %LOCALAPPDATA%\MSR |
|
|
| Manual extraction is normally not required. |
|
|
| ## Included Components |
|
|
| The Runtime package includes: |
|
|
| - Python 3.12 runtime |
| - CUDA-enabled PyTorch environment |
| - NVIDIA Kimodo runtime components |
| - Kimodo-SOMA-RP-v1.1 motion model |
| - MotionSmith backend workers |
| - LLM2Vec MNTP adapter |
| - LLM2Vec supervised adapter |
| - Tokenizer and text-encoder support files |
| - Runtime diagnostics and validation resources |
| - Required third-party Python dependencies |
| - Third-party license and attribution files |
|
|
| ## Meta Llama 3 |
|
|
| **Meta Llama 3 model weights are NOT included in this repository or in the MotionSmith Runtime package.** |
|
|
| MotionSmith uses **Meta Llama 3 8B Instruct** together with LLM2Vec for text encoding. |
|
|
| Users obtain Meta Llama 3 separately from the official Meta repository on Hugging Face after accepting the applicable Meta license and access terms. |
|
|
| MotionSmith can download and configure the model from within its setup interface using the user's own Hugging Face read token. |
|
|
| The Hugging Face token is used only for the requested download and is not stored permanently by MotionSmith. |
|
|
| Existing local Meta Llama 3 installations can also be selected manually. |
|
|
| **Built with Meta Llama 3.** |
|
|
| ## Runtime Validation |
|
|
| MotionSmith validates the Runtime before generation and checks components including: |
|
|
| - Runtime version |
| - Python |
| - PyTorch |
| - CUDA availability |
| - NVIDIA Kimodo |
| - Motion model |
| - LLM2Vec adapters |
| - Meta Llama 3 |
| - Backend worker availability |
|
|
| The MotionSmith Diagnostics / Pre-Flight system reports whether the environment is ready for animation generation. |
|
|
| ## Platform |
|
|
| Current release target: |
|
|
| - Windows 64-bit |
| - Unreal Engine 5.8 |
| - NVIDIA CUDA-capable GPU |
|
|
| MotionSmith Runtime 1.0.0 has been tested with the MotionSmith 1.0.0 Unreal Engine plugin. |
|
|
| ## Licensing |
|
|
| This repository contains components distributed under multiple independent licenses. |
|
|
| No single license applies to every component contained in the MotionSmith Runtime package. |
|
|
| Third-party license texts, notices, source information, and attribution records are included under: |
|
|
| `Licenses/` |
|
|
| Major components include software and/or model assets from projects such as: |
|
|
| - NVIDIA Kimodo |
| - LLM2Vec / McGill-NLP |
| - Python |
| - PyTorch |
| - Hugging Face libraries |
| - Other third-party Python dependencies |
|
|
| Each component remains subject to its respective license terms. |
|
|
| See the repository `LICENSE` file and the `Licenses/` directory inside the Runtime package for details. |
|
|
| ## Distribution |
|
|
| This Runtime repository exists to support legitimate installations of MotionSmith. |
|
|
| Do not treat the complete Runtime archive as a separately licensed standalone product or assume that all bundled third-party components may be redistributed independently of their respective licenses. |
|
|
| ## MotionSmith |
|
|
| **MotionSmith - AI Animation Studio** provides AI-assisted human motion generation, continuation, editing, pose authoring, timeline workflows, and retargeting inside Unreal Engine. |
|
|
| Powered by NVIDIA Kimodo. |
