Upload folder using huggingface_hub

.gitattributes

@@ -33,3 +33,4 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+SprongMotion-14M-v1.0-Q8_0.gguf filter=lfs diff=lfs merge=lfs -text

LICENSE

@@ -0,0 +1,202 @@
+
+                                 Apache License
+                           Version 2.0, January 2004
+                        http://www.apache.org/licenses/
+
+   TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
+
+   1. Definitions.
+
+      "License" shall mean the terms and conditions for use, reproduction,
+      and distribution as defined by Sections 1 through 9 of this document.
+
+      "Licensor" shall mean the copyright owner or entity authorized by
+      the copyright owner that is granting the License.
+
+      "Legal Entity" shall mean the union of the acting entity and all
+      other entities that control, are controlled by, or are under common
+      control with that entity. For the purposes of this definition,
+      "control" means (i) the power, direct or indirect, to cause the
+      direction or management of such entity, whether by contract or
+      otherwise, or (ii) ownership of fifty percent (50%) or more of the
+      outstanding shares, or (iii) beneficial ownership of such entity.
+
+      "You" (or "Your") shall mean an individual or Legal Entity
+      exercising permissions granted by this License.
+
+      "Source" form shall mean the preferred form for making modifications,
+      including but not limited to software source code, documentation
+      source, and configuration files.
+
+      "Object" form shall mean any form resulting from mechanical
+      transformation or translation of a Source form, including but
+      not limited to compiled object code, generated documentation,
+      and conversions to other media types.
+
+      "Work" shall mean the work of authorship, whether in Source or
+      Object form, made available under the License, as indicated by a
+      copyright notice that is included in or attached to the work
+      (an example is provided in the Appendix below).
+
+      "Derivative Works" shall mean any work, whether in Source or Object
+      form, that is based on (or derived from) the Work and for which the
+      editorial revisions, annotations, elaborations, or other modifications
+      represent, as a whole, an original work of authorship. For the purposes
+      of this License, Derivative Works shall not include works that remain
+      separable from, or merely link (or bind by name) to the interfaces of,
+      the Work and Derivative Works thereof.
+
+      "Contribution" shall mean any work of authorship, including
+      the original version of the Work and any modifications or additions
+      to that Work or Derivative Works thereof, that is intentionally
+      submitted to Licensor for inclusion in the Work by the copyright owner
+      or by an individual or Legal Entity authorized to submit on behalf of
+      the copyright owner. For the purposes of this definition, "submitted"
+      means any form of electronic, verbal, or written communication sent
+      to the Licensor or its representatives, including but not limited to
+      communication on electronic mailing lists, source code control systems,
+      and issue tracking systems that are managed by, or on behalf of, the
+      Licensor for the purpose of discussing and improving the Work, but
+      excluding communication that is conspicuously marked or otherwise
+      designated in writing by the copyright owner as "Not a Contribution."
+
+      "Contributor" shall mean Licensor and any individual or Legal Entity
+      on behalf of whom a Contribution has been received by Licensor and
+      subsequently incorporated within the Work.
+
+   2. Grant of Copyright License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      copyright license to reproduce, prepare Derivative Works of,
+      publicly display, publicly perform, sublicense, and distribute the
+      Work and such Derivative Works in Source or Object form.
+
+   3. Grant of Patent License. Subject to the terms and conditions of
+      this License, each Contributor hereby grants to You a perpetual,
+      worldwide, non-exclusive, no-charge, royalty-free, irrevocable
+      (except as stated in this section) patent license to make, have made,
+      use, offer to sell, sell, import, and otherwise transfer the Work,
+      where such license applies only to those patent claims licensable
+      by such Contributor that are necessarily infringed by their
+      Contribution(s) alone or by combination of their Contribution(s)
+      with the Work to which such Contribution(s) was submitted. If You
+      institute patent litigation against any entity (including a
+      cross-claim or counterclaim in a lawsuit) alleging that the Work
+      or a Contribution incorporated within the Work constitutes direct
+      or contributory patent infringement, then any patent licenses
+      granted to You under this License for that Work shall terminate
+      as of the date such litigation is filed.
+
+   4. Redistribution. You may reproduce and distribute copies of the
+      Work or Derivative Works thereof in any medium, with or without
+      modifications, and in Source or Object form, provided that You
+      meet the following conditions:
+
+      (a) You must give any other recipients of the Work or
+          Derivative Works a copy of this License; and
+
+      (b) You must cause any modified files to carry prominent notices
+          stating that You changed the files; and
+
+      (c) You must retain, in the Source form of any Derivative Works
+          that You distribute, all copyright, patent, trademark, and
+          attribution notices from the Source form of the Work,
+          excluding those notices that do not pertain to any part of
+          the Derivative Works; and
+
+      (d) If the Work includes a "NOTICE" text file as part of its
+          distribution, then any Derivative Works that You distribute must
+          include a readable copy of the attribution notices contained
+          within such NOTICE file, excluding those notices that do not
+          pertain to any part of the Derivative Works, in at least one
+          of the following places: within a NOTICE text file distributed
+          as part of the Derivative Works; within the Source form or
+          documentation, if provided along with the Derivative Works; or,
+          within a display generated by the Derivative Works, if and
+          wherever such third-party notices normally appear. The contents
+          of the NOTICE file are for informational purposes only and
+          do not modify the License. You may add Your own attribution
+          notices within Derivative Works that You distribute, alongside
+          or as an addendum to the NOTICE text from the Work, provided
+          that such additional attribution notices cannot be construed
+          as modifying the License.
+
+      You may add Your own copyright statement to Your modifications and
+      may provide additional or different license terms and conditions
+      for use, reproduction, or distribution of Your modifications, or
+      for any such Derivative Works as a whole, provided Your use,
+      reproduction, and distribution of the Work otherwise complies with
+      the conditions stated in this License.
+
+   5. Submission of Contributions. Unless You explicitly state otherwise,
+      any Contribution intentionally submitted for inclusion in the Work
+      by You to the Licensor shall be under the terms and conditions of
+      this License, without any additional terms or conditions.
+      Notwithstanding the above, nothing herein shall supersede or modify
+      the terms of any separate license agreement you may have executed
+      with Licensor regarding such Contributions.
+
+   6. Trademarks. This License does not grant permission to use the trade
+      names, trademarks, service marks, or product names of the Licensor,
+      except as required for reasonable and customary use in describing the
+      origin of the Work and reproducing the content of the NOTICE file.
+
+   7. Disclaimer of Warranty. Unless required by applicable law or
+      agreed to in writing, Licensor provides the Work (and each
+      Contributor provides its Contributions) on an "AS IS" BASIS,
+      WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
+      implied, including, without limitation, any warranties or conditions
+      of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
+      PARTICULAR PURPOSE. You are solely responsible for determining the
+      appropriateness of using or redistributing the Work and assume any
+      risks associated with Your exercise of permissions under this License.
+
+   8. Limitation of Liability. In no event and under no legal theory,
+      whether in tort (including negligence), contract, or otherwise,
+      unless required by applicable law (such as deliberate and grossly
+      negligent acts) or agreed to in writing, shall any Contributor be
+      liable to You for damages, including any direct, indirect, special,
+      incidental, or consequential damages of any character arising as a
+      result of this License or out of the use or inability to use the
+      Work (including but not limited to damages for loss of goodwill,
+      work stoppage, computer failure or malfunction, or any and all
+      other commercial damages or losses), even if such Contributor
+      has been advised of the possibility of such damages.
+
+   9. Accepting Warranty or Additional Liability. While redistributing
+      the Work or Derivative Works thereof, You may choose to offer,
+      and charge a fee for, acceptance of support, warranty, indemnity,
+      or other liability obligations and/or rights consistent with this
+      License. However, in accepting such obligations, You may act only
+      on Your own behalf and on Your sole responsibility, not on behalf
+      of any other Contributor, and only if You agree to indemnify,
+      defend, and hold each Contributor harmless for any liability
+      incurred by, or claims asserted against, such Contributor by reason
+      of your accepting any such warranty or additional liability.
+
+   END OF TERMS AND CONDITIONS
+
+   APPENDIX: How to apply the Apache License to your work.
+
+      To apply the Apache License to your work, attach the following
+      boilerplate notice, with the fields enclosed by brackets "[]"
+      replaced with your own identifying information. (Don't include
+      the brackets!)  The text should be enclosed in the appropriate
+      comment syntax for the file format. We also recommend that a
+      file or class name and description of purpose be included on the
+      same "printed page" as the copyright notice for easier
+      identification within third-party archives.
+
+   Copyright [yyyy] [name of copyright owner]
+
+   Licensed under the Apache License, Version 2.0 (the "License");
+   you may not use this file except in compliance with the License.
+   You may obtain a copy of the License at
+
+       http://www.apache.org/licenses/LICENSE-2.0
+
+   Unless required by applicable law or agreed to in writing, software
+   distributed under the License is distributed on an "AS IS" BASIS,
+   WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+   See the License for the specific language governing permissions and
+   limitations under the License.

NOTICE

@@ -0,0 +1,27 @@
+SprongMotion-14M 1.0
+Copyright 2026 Seger Endendijk (segerend.nl)
+
+Licensed under the Apache License, Version 2.0: see LICENSE.
+
+Provenance
+
+Most training motions were generated using NVIDIA Kimodo (nvidia/Kimodo-SOMA-RP-v1.1),
+used under the NVIDIA Open Model License, under which NVIDIA claims no ownership rights in outputs.
+This Model is not endorsed by NVIDIA. No part of the Kimodo model (weights or code) is included in this
+Model.
+
+Other sources:
+- 100STYLE, Ian Mason, Sebastian Starke, Taku Komura. CC BY 4.0. https://zenodo.org/records/8127870
+- AddBiomechanics Dataset 1.0, Werling et al. CC BY 4.0. https://addbiomechanics.org/download_data.html
+- Mesh2Motion human animation library (Scott Petrovic and contributors, base set from the Quaternius
+  Universal Animation Library). CC0 1.0. https://github.com/Mesh2Motion/mesh2motion-app
+- KayKit Character Pack: Adventurers 1.0 and Skeletons 1.0, Kay Lousberg (www.kaylousberg.com). CC0 1.0.
+  https://github.com/KayKit-Game-Assets
+- FreeMotionPack1, J-Beardmore. CC0 1.0. https://github.com/J-Beardmore/FreeMotionPack1
+- granite-embedding-small-english-r2, IBM (text encoder initialisation). Apache-2.0.
+  https://huggingface.co/ibm-granite/granite-embedding-small-english-r2
+- Qwen3-Embedding-4B and Qwen3-8B, Qwen team (text encoder targets, caption paraphrases). Apache-2.0.
+  https://huggingface.co/Qwen
+- CLIP BPE vocabulary, Copyright (c) 2021 OpenAI. MIT. https://github.com/openai/CLIP
+
+The training data is not included and is not licensed under LICENSE.

README.md

@@ -0,0 +1,230 @@
+---
+license: apache-2.0
+language: [en]
+pipeline_tag: text-to-3d
+datasets: [SegerEnd/SprongMotion-100K]
+tags: [text-to-motion, motion-generation, animation, gguf]
+---
+
+# SprongMotion-14M 1.0
+
+SprongMotion-14M is a compact text-to-motion model that turns English descriptions into 3D human animation. Describe an action, and the model generates a motion sequence for a 22-joint human skeleton at 20 FPS, with durations ranging from 0.5 to 10 seconds.
+
+It runs on a plain CPU, no GPU. On an Apple M4, a 10 s clip takes about 0.23 s with 10 threads and about 1.2 s on one thread, and about 1.4 s in WebAssembly (SIMD, one thread, Node). The model is one 33 MB file.
+
+Model size: 20.0M parameters across the complete model package, including a 13.8M-parameter motion generator. The model is named SprongMotion-14M after its generator.
+
+The model is designed to be practical, not just experimental. Its quantized weights fit in a single GGUF file, and the [SprongMotion C runtime](https://github.com/SegerEnd/sprongmotion-runtime) supports native and WebAssembly deployment, including CPU-only environments and the browser.
+
+| | |
+|---|---|
+| Parameters | 20.0M: motion generator 13.8M, text encoder 2.4M, motion tokenizer 3.8M |
+| File | `SprongMotion-14M-v1.0-Q8_0.gguf`, 33.3 MB (33,337,824 bytes) |
+| SHA256 | `68fbd311a0d7d75f60508b35254171583c85880e7e124140457b57ac84c5de9d` |
+| Format | GGUF, generator weights Q8_0, the other parts F32 |
+| Skeleton | 22 joints, no fingers |
+| Frame rate | 20 fps |
+| Length | 0.5 to 10 s per clip, longer motion as several prompt blocks |
+| Input | English text |
+| Runtime | [SprongMotion runtime](https://github.com/SegerEnd/sprongmotion-runtime) 1.0.0 or newer |
+| License | Apache-2.0 |
+
+## Highlights
+
+**Text to motion:** Generate walking, running, jumping, turning, dancing, sports movements, and other everyday actions from English prompts.
+
+**Lightweight:** 20.0M parameters in all, packaged in a single 33 MB GGUF file.
+
+**CPU-friendly:** Run inference without requiring a GPU.
+
+**Animation-ready output:** Joint positions and rotations, root trajectories, foot contacts, and BVH export.
+
+**Editable motion:** Support for inpainting, pinned frames and codes, looping, prompt timelines, and root-path control through the runtime.
+
+**Reproducible inference:** Identical prompts produce bit-identical results across exact builds of the runtime, including native and WebAssembly builds.
+
+## Getting started
+
+**Want to try it? Use Blender.** The [SprongMotion add-on](https://github.com/SegerEnd/sprongmotion-blender) bundles the
+runtime and this model. Install the zip for your system (Edit > Preferences > Get Extensions > Install from Disk), select
+an armature, open the Timeline sidebar (N) and type a motion.
+
+**Want to integrate it? Use the C runtime.** Download the model, build the
+[SprongMotion runtime](https://github.com/SegerEnd/sprongmotion-runtime) (a C11 compiler and make) and run the example,
+which writes a BVH file you can open in Blender or a game engine:
+
+```sh
+hf download SegerEnd/SprongMotion-14M SprongMotion-14M-v1.0-Q8_0.gguf --local-dir .
+git clone https://github.com/SegerEnd/sprongmotion-runtime
+make -C sprongmotion-runtime build/examples/01_hello
+sprongmotion-runtime/build/examples/01_hello SprongMotion-14M-v1.0-Q8_0.gguf "waves with the right hand" wave.bvh
+```
+
+[examples/01_hello.c](https://github.com/SegerEnd/sprongmotion-runtime/blob/main/examples/01_hello.c) is the whole program
+in 34 lines: headers, loading with error handling, generating, the frame count and BVH export, cleanup. The other
+examples cover parameters, progress and cancel, and editing.
+
+**Want to deploy it in a browser? Use WebAssembly.** The runtime's WebAssembly build runs the same model in a browser or
+node, with the same output as native:
+[examples/05_wasm.mjs](https://github.com/SegerEnd/sprongmotion-runtime/blob/main/examples/05_wasm.mjs) loads it and turns
+a prompt into BVH text.
+
+The GGUF package contains the tokenizer, text encoder, motion generators, motion decoder and encoder, reference skeleton, and default sampling configuration. The model file alone is not the complete runtime.
+
+## Prompting
+
+Write one action per prompt, in plain English: "a person walks forward", "waves with the right hand", "jumps up high", "turns around", "sits down". A subject such as "a person" is not necessarily needed. Side, direction, speed, count and style words are part of the training captions.
+
+- For a sequence, use several prompt blocks (walk, then turn, then sit) rather than one long sentence.
+- Give runs a direction: "runs forward", not just "runs" (that one can float or drift).
+- Sitting, lying and stepping up use an invisible prop, as in game animation: "sits down" sits on nothing.
+- A different seed gives a different take of the same prompt.
+
+## Intended uses
+
+SprongMotion is intended for:
+
+- Game animation and prototyping.
+- Film previsualization and animation blocking.
+- Procedural character animation.
+- Interactive 3D applications and browser-based experiments.
+- Education and research into compact generative motion models.
+
+It is not intended for biomechanical measurement, clinical assessment, or accurate reconstruction of real human movement.
+
+## Known weaknesses
+
+- Pirouettes and fast spins can glitch: single frames with a large jump in facing.
+- Seams between blocks with different prompts are sometimes rougher than motion inside a block (timelines, continuing a clip with a new prompt).
+- Feet can slide in walks, most in the switch from walking to standing.
+- A plain "a person runs" (no direction) sometimes floats or drifts off. "a person runs forward" does not.
+- Fine detail of hands and fingers is not modelled (22 joints, no fingers). No contact with objects.
+- English-only input: Prompts in other languages are not supported as a target use case.
+- Unfamiliar actions: Actions outside the training distribution may be approximated by more familiar movements.
+
+## License
+
+The released model is distributed under the Apache License 2.0. [LICENSE](LICENSE).
+
+**Licensor**: Seger Endendijk - segerend.nl
+
+Please do not use SprongMotion for military, warfare, nuclear or espionage purposes.
+
+If you use SprongMotion in your work (project, application, publication, demonstration or presentation), a credit to Seger Endendijk (segerend.nl) is appreciated.
+
+## Technical details
+
+<details>
+<summary>What is inside the model</summary>
+
+SprongMotion-14M uses a masked-token generator and a residual-token generator operating on a vector-quantized motion representation.
+
+The architecture consists of:
+
+- A six-layer motion VQ tokenizer, with one token per two motion frames.
+- A compact text encoder that provides token-level states and a pooled text representation.
+- A masked token generator for motion generation.
+- A residual token generator for refining the motion representation.
+- A motion decoder that converts generated representations into skeletal motion.
+
+The GGUF file includes all the components needed by the runtime to perform inference and work with motion representations. The runtime's [design notes](https://github.com/SegerEnd/sprongmotion-runtime/blob/main/docs/design.md) describe the file and the network in detail.
+
+</details>
+
+<details>
+<summary>Training and data</summary>
+
+SprongMotion-14M was trained on approximately 120,000 motion clips.
+
+Most of the motions were generated by using NVIDIA Kimodo from written prompts. They are released as the [SprongMotion-100K](https://huggingface.co/datasets/SegerEnd/SprongMotion-100K) dataset. These generated clips were checked using measurements and visual inspection. The remaining data consists of motion-capture sequences and hand-keyed game animations.
+
+Training captions include original prompts, descriptions derived from measurable motion properties such as speed, turns, and repetition counts, and checked paraphrases.
+
+The text encoder was initialized using Granite embeddings and distilled using targets from Qwen3-Embedding-4B. Qwen3-8B was used to produce caption paraphrases that were subsequently checked.
+
+No training data under a non-commercial license was used.
+
+</details>
+
+<details>
+<summary>Measured checks</summary>
+
+There is no standard benchmark score for this model. These are the targeted checks run on the released model (C runtime, several seeds per prompt):
+
+| Check | Result |
+|---|---|
+| "a person walks forward": speed over the whole clip | 0.8 m/s |
+| "a person runs forward": clips floating above the ground | 0 of 48 |
+| Jogging: speed | 1.39 m/s |
+| Lying down: pelvis height, start to end | 0.98 m to 0.12 m |
+| Hops, turns of 180 degrees, walking in a circle: clips that do it | 12 of 12, 11 of 12, 12 of 12 |
+
+</details>
+
+## Provenance
+
+Most training motions were generated by the Licensor using NVIDIA Kimodo (nvidia/Kimodo-SOMA-RP-v1.1), used under the NVIDIA Open Model License, under which NVIDIA claims no ownership rights in outputs. This Model is not endorsed by NVIDIA. No part of the Kimodo model (weights or code) is included in this Model.
+https://huggingface.co/nvidia/Kimodo-SOMA-RP-v1.1 ,
+https://www.nvidia.com/en-us/agreements/enterprise-software/nvidia-open-model-license/
+
+<details>
+<summary>Other sources, each used under its own license</summary>
+
+| Source | Used for | License | Link |
+|---|---|---|---|
+| 100STYLE (Ian Mason, Sebastian Starke, Taku Komura) | styled locomotion | CC BY 4.0 | https://zenodo.org/records/8127870 |
+| AddBiomechanics Dataset 1.0, high-quality core (Werling et al.), subjects with arm motion | walking, running, jumps, sports, everyday tasks | CC BY 4.0 | https://addbiomechanics.org/download_data.html |
+| Mesh2Motion human animation library (base set from the Quaternius Universal Animation Library) | hand-keyed game moves | CC0 1.0 | https://github.com/Mesh2Motion/mesh2motion-app , https://quaternius.com/packs/universalanimationlibrary.html |
+| KayKit Character Pack: Adventurers 1.0 and Skeletons 1.0 (Kay Lousberg) | hand-keyed game moves | CC0 1.0 | https://github.com/KayKit-Game-Assets/KayKit-Character-Pack-Adventures-1.0 , https://github.com/KayKit-Game-Assets/KayKit-Character-Pack-Skeletons-1.0 |
+| FreeMotionPack1 (J-Beardmore) | emotes | CC0 1.0 | https://github.com/J-Beardmore/FreeMotionPack1 |
+| granite-embedding-small-english-r2 (IBM) | text encoder initialisation | Apache-2.0 | https://huggingface.co/ibm-granite/granite-embedding-small-english-r2 |
+| Qwen3-Embedding-4B (Qwen team) | text encoder distillation targets | Apache-2.0 | https://huggingface.co/Qwen/Qwen3-Embedding-4B |
+| Qwen3-8B (Qwen team) | caption paraphrases | Apache-2.0 | https://huggingface.co/Qwen/Qwen3-8B |
+| CLIP BPE vocabulary (OpenAI) | the tokenizer's merges | MIT | https://github.com/openai/CLIP |
+
+The training data itself is not part of this release and is not licensed under LICENSE.
+
+</details>
+
+## How to cite
+
+If you use SprongMotion in research or other published work, please cite the model:
+
+```bibtex
+@misc{endendijk2026sprongmotion,
+  author = {Endendijk, Seger},
+  title  = {SprongMotion-14M: a small text-to-motion model},
+  year   = {2026},
+  howpublished = {\url{https://huggingface.co/SegerEnd/SprongMotion-14M}},
+  note   = {Version 1.0, https://segerend.nl}
+}
+```
+
+<details>
+<summary>Upstream citations</summary>
+
+Please also cite the relevant upstream datasets and research publications when using their contributions.
+
+```bibtex
+@article{mason2022style,
+  author  = {Mason, Ian and Starke, Sebastian and Komura, Taku},
+  title   = {Real-Time Style Modelling of Human Locomotion via Feature-Wise Transformations and Local Motion Phases},
+  journal = {Proceedings of the ACM on Computer Graphics and Interactive Techniques},
+  year    = {2022},
+  doi     = {10.1145/3522618}
+}
+@inproceedings{werling2024addbiomechanics,
+  author    = {Werling, Keenon and Kaneda, Janelle and Tan, Tian and Agarwal, Rishi and Skov, Six and Van Wouwe, Tom and
+               Uhlrich, Scott and Bianco, Nicholas and Ong, Carmichael and Falisse, Antoine and Sapkota, Shardul and
+               Chandra, Aidan and Carter, Joshua and Preatoni, Ezio and Fregly, Benjamin and Hicks, Jennifer and
+               Delp, Scott and Liu, C. Karen},
+  title     = {AddBiomechanics Dataset: Capturing the Physics of Human Motion at Scale},
+  booktitle = {Computer Vision -- ECCV 2024},
+  pages     = {490--508},
+  publisher = {Springer Nature Switzerland},
+  year      = {2025},
+  doi       = {10.1007/978-3-031-73223-2_27}
+}
+```
+
+</details>

SprongMotion-14M-v1.0-Q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:68fbd311a0d7d75f60508b35254171583c85880e7e124140457b57ac84c5de9d
+size 33337824