Publish Kokoro-82M F16/Q8_0 and all 54 official voices

.gitattributes

@@ -1,35 +1 @@
-*.7z filter=lfs diff=lfs merge=lfs -text
-*.arrow filter=lfs diff=lfs merge=lfs -text
-*.bin filter=lfs diff=lfs merge=lfs -text
-*.bz2 filter=lfs diff=lfs merge=lfs -text
-*.ckpt filter=lfs diff=lfs merge=lfs -text
-*.ftz filter=lfs diff=lfs merge=lfs -text
-*.gz filter=lfs diff=lfs merge=lfs -text
-*.h5 filter=lfs diff=lfs merge=lfs -text
-*.joblib filter=lfs diff=lfs merge=lfs -text
-*.lfs.* filter=lfs diff=lfs merge=lfs -text
-*.mlmodel filter=lfs diff=lfs merge=lfs -text
-*.model filter=lfs diff=lfs merge=lfs -text
-*.msgpack filter=lfs diff=lfs merge=lfs -text
-*.npy filter=lfs diff=lfs merge=lfs -text
-*.npz filter=lfs diff=lfs merge=lfs -text
-*.onnx filter=lfs diff=lfs merge=lfs -text
-*.ot filter=lfs diff=lfs merge=lfs -text
-*.parquet filter=lfs diff=lfs merge=lfs -text
-*.pb filter=lfs diff=lfs merge=lfs -text
-*.pickle filter=lfs diff=lfs merge=lfs -text
-*.pkl filter=lfs diff=lfs merge=lfs -text
-*.pt filter=lfs diff=lfs merge=lfs -text
-*.pth filter=lfs diff=lfs merge=lfs -text
-*.rar filter=lfs diff=lfs merge=lfs -text
-*.safetensors filter=lfs diff=lfs merge=lfs -text
-saved_model/**/* filter=lfs diff=lfs merge=lfs -text
-*.tar.* filter=lfs diff=lfs merge=lfs -text
-*.tar filter=lfs diff=lfs merge=lfs -text
-*.tflite filter=lfs diff=lfs merge=lfs -text
-*.tgz filter=lfs diff=lfs merge=lfs -text
-*.wasm filter=lfs diff=lfs merge=lfs -text
-*.xz 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
+*.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.

PROVENANCE.md

@@ -0,0 +1,65 @@
+# Provenance and checksums
+
+- Source: <https://huggingface.co/hexgrad/Kokoro-82M>
+- Revision: `f3ff3571791e39611d31c381e3a41a3af07b4987`
+- Checkpoint SHA256: `496dba118d1a58f5f3db2efc88dbdc216e0483fc89fe6e47ee1f2c53f18ad1e4`
+- Converter/runtime: <https://github.com/simonfxr/kokoro.cpp>
+
+| File | Bytes | SHA256 |
+|---|---:|---|
+| `kokoro-82m-f16.gguf` | 163,728,096 | `597926de84f5550e1526ce0abde4e496209d464afc9274d8603d14f3c04d1f67` |
+| `kokoro-82m-q8_0.gguf` | 141,322,752 | `61cc0186b3a761bdc31ba5d83b9228e4a72bf974cc5b94c281a5f450e683d2cc` |
+| `voices/kokoro-voice-af_alloy.gguf` | 522,560 | `6201a548c5cb29862687089a204704b317e77966281c670f4a327379a85014c6` |
+| `voices/kokoro-voice-af_aoede.gguf` | 522,560 | `e8af69ae5eb4a05f55ed4a5916deacc11a694bf9792a7d68948cf7a50b2831a6` |
+| `voices/kokoro-voice-af_bella.gguf` | 522,560 | `63d24d0e5d91cb6cf3bca294a3b8c0b4428aa54ac9b5de42e5ba07f6bd110ea8` |
+| `voices/kokoro-voice-af_heart.gguf` | 522,560 | `c2f44076dfb8f9c098a85d634f6d6b46b038f80e3afdf695ff3b90f6d9ef473f` |
+| `voices/kokoro-voice-af_jessica.gguf` | 522,560 | `58001aae46df272fde02bb25766c61271f7b9523d3e95635ac33d5ef5a4e1837` |
+| `voices/kokoro-voice-af_kore.gguf` | 522,560 | `bfedbada16a3541f13679988e5a82c20e35d65fb09a967aaf57b23d25e97fc52` |
+| `voices/kokoro-voice-af_nicole.gguf` | 522,560 | `04bee67dd22b1eb687e50187c6851db96b6a1ebeee96daf5ec9448427a1bce42` |
+| `voices/kokoro-voice-af_nova.gguf` | 522,560 | `bad32b526d3b4ece8b38dc901bbfcfbfa8f54aa03990042bc5054967f7028501` |
+| `voices/kokoro-voice-af_river.gguf` | 522,560 | `4728ac1a68ba61bb7385b213c67a6f0914b5713dfb3c8146d698a593ab61e4c9` |
+| `voices/kokoro-voice-af_sarah.gguf` | 522,560 | `43cedb17753fd8fae61a1583a81b93a2bf360ccc48c69b9ea2f1a09aa647f0bc` |
+| `voices/kokoro-voice-af_sky.gguf` | 522,560 | `6e4938f82892154eb2793644cb679c8198be863009c0e2e19b529a65af0ad9e3` |
+| `voices/kokoro-voice-am_adam.gguf` | 522,560 | `4cad76e54f38f2ba97811caa97ed220feb7f0973b0fbfe719e0a8b8ca2561634` |
+| `voices/kokoro-voice-am_echo.gguf` | 522,560 | `cf8b334c10d2ded6e45f224bf5d9e1ac49b066a288ec374beaa4283dd80c408b` |
+| `voices/kokoro-voice-am_eric.gguf` | 522,560 | `27c1d63ca2e811439aa14c3c2d93d53bacdf5f2df0a4bb88aaf9fbff7eb3a52f` |
+| `voices/kokoro-voice-am_fenrir.gguf` | 522,560 | `3983d48599b5e219f581ea4fbc186d9181101d282cd2715d521775ba8a6ba882` |
+| `voices/kokoro-voice-am_liam.gguf` | 522,560 | `1dd91a0788afc92cbc822fed6d6ca0e318d96a286312a2167468d805dc73819f` |
+| `voices/kokoro-voice-am_michael.gguf` | 522,560 | `a2b71b49dd6320a2e235f8dfd176b197a2f76d5b32c1e3222efb08f117e78335` |
+| `voices/kokoro-voice-am_onyx.gguf` | 522,560 | `dd905c10ca5ba4463081e9d0744e1d8a267877a1f143b7cec57baa225e82708c` |
+| `voices/kokoro-voice-am_puck.gguf` | 522,560 | `e72ebb9c3599dbff4c3cfa83e5b28708641dbe3e2619bdc0282d8c314437b3ff` |
+| `voices/kokoro-voice-am_santa.gguf` | 522,560 | `8fe64822d3e2a47b6b9dd122f3b901557d709e12cf11c2624524131433798417` |
+| `voices/kokoro-voice-bf_alice.gguf` | 522,560 | `3aafb603c8c20830e5d3b22588eeffec2a95a2e1899fb3cd768067cd16e93e24` |
+| `voices/kokoro-voice-bf_emma.gguf` | 522,560 | `78d519c9bfd34b5e15475169d0757cc77a8a3053d05dce65d3fcb77bf6743448` |
+| `voices/kokoro-voice-bf_isabella.gguf` | 522,560 | `aa896efd783a4d5533c9ddb13ab6464a214ccd7a487b30d5e254e0b5b271d035` |
+| `voices/kokoro-voice-bf_lily.gguf` | 522,560 | `63c2085d71741cc39a0f7044c56f81aa5979e58447003d37c685d9ff1835ae03` |
+| `voices/kokoro-voice-bm_daniel.gguf` | 522,560 | `4fdd111e8668ea12f1b5a8f91a217b1e69b877e1f87da88c79d86216154d490b` |
+| `voices/kokoro-voice-bm_fable.gguf` | 522,560 | `5d870c3b12412cd5139797966ed17913180f523b79c4bc6c3afed1c5b97ec0c1` |
+| `voices/kokoro-voice-bm_george.gguf` | 522,560 | `c72650919593bfeef032b898dfb53ebd192b70ae91081f81697469e6f8914718` |
+| `voices/kokoro-voice-bm_lewis.gguf` | 522,560 | `01b151df68b16e8d9bee3ea497b13d9f0fc8ee14c69a3a95e49515837c6cf3c9` |
+| `voices/kokoro-voice-ef_dora.gguf` | 522,560 | `7fa2a87038c41301363e8e7d97bad2260c20da1a786ec22e0ea954d67dc4c412` |
+| `voices/kokoro-voice-em_alex.gguf` | 522,560 | `bf44594da819e77b4575d9912b8d4b2ab73d67a6a2b17031412a826b98db2b6f` |
+| `voices/kokoro-voice-em_santa.gguf` | 522,560 | `08f06a2e88461d8dff40cc090bbafa72e1d2bb5aa156261ac00613abef2a459f` |
+| `voices/kokoro-voice-ff_siwis.gguf` | 522,560 | `ebeb2847f5a56301af4d61fd31e5c568dfc05b4017694784e86eff9b17d08296` |
+| `voices/kokoro-voice-hf_alpha.gguf` | 522,560 | `e1948214324b9af419ab10053caeb303752f4feee6e641d1dae9a04cdcd57036` |
+| `voices/kokoro-voice-hf_beta.gguf` | 522,560 | `5b750bedc1b0766db556cb29d4fa4376c0cd91399841a72110e4a4036288375a` |
+| `voices/kokoro-voice-hm_omega.gguf` | 522,560 | `a9de65ffa67db1e640af89cbdf0b129ad5e603a8099bec01a98bedd31bdbd2cb` |
+| `voices/kokoro-voice-hm_psi.gguf` | 522,560 | `6c750875b70910475f5ec5cc53ef218bfc464ede6065a29fb66ce4d6aeb3252e` |
+| `voices/kokoro-voice-if_sara.gguf` | 522,560 | `cfc7d3a2ab08df1791ea0e4518c66d0191e91376b1ae437adea826d9556b7b70` |
+| `voices/kokoro-voice-im_nicola.gguf` | 522,560 | `c7e862be2d30a4dba1403b9c6959eb10ab051576faea6bfd45accd8982cdfb52` |
+| `voices/kokoro-voice-jf_alpha.gguf` | 522,560 | `482bf66e90ff6f42c0edf30ec4fb7f7d840347d4b76e8c3ea2bb59932c29f441` |
+| `voices/kokoro-voice-jf_gongitsune.gguf` | 522,592 | `d591f7ccfc63ea980634d4e7f9c2066cb12a74c142be952e68872298cf74fc8a` |
+| `voices/kokoro-voice-jf_nezumi.gguf` | 522,560 | `e2ca00ade95793c508b4352598207a2f324b4b90c5a1725939adbc93a80e65b4` |
+| `voices/kokoro-voice-jf_tebukuro.gguf` | 522,560 | `491505fa90aecae4122f1b9576b232c27486f120a4a64cfdf5e624d9a0d8dc64` |
+| `voices/kokoro-voice-jm_kumo.gguf` | 522,560 | `36af9904115efeb8f7bc950dc652ba96208803e89e871a801bad63cd0279c1f6` |
+| `voices/kokoro-voice-pf_dora.gguf` | 522,560 | `a08314e467100dcb995d520ac0ccc52860d3b0484df7be1a51308a26127e72bd` |
+| `voices/kokoro-voice-pm_alex.gguf` | 522,560 | `8fc600cecf187070752ea27751f9e1383a0b05a0dd585848fc0d561d16a45072` |
+| `voices/kokoro-voice-pm_santa.gguf` | 522,560 | `4bddeba8bc0c05a370805af3ab09180a04100306d5ade588b38c127b6e74688e` |
+| `voices/kokoro-voice-zf_xiaobei.gguf` | 522,560 | `9d6ab39cba27274ace22170c47e1c4bafe556d95413fd2fe3b8d5be1f37c2fbb` |
+| `voices/kokoro-voice-zf_xiaoni.gguf` | 522,560 | `bde67c9715cec5cc416546a1eba44e4e04055a7218f9ea61bfd83f9bf0125c11` |
+| `voices/kokoro-voice-zf_xiaoxiao.gguf` | 522,560 | `f9e39176aae25ddd088102d0f37649a1115526f6818b0bd09002bf5dc35d22e5` |
+| `voices/kokoro-voice-zf_xiaoyi.gguf` | 522,560 | `32912eac11cb36d530d403e26b563beebdba2b74f772ffa5920eaf0aa5d45278` |
+| `voices/kokoro-voice-zm_yunjian.gguf` | 522,560 | `cb2e5965f183db685d5895d55d3f924e41398c9934a3464dd869d8c1261feba8` |
+| `voices/kokoro-voice-zm_yunxi.gguf` | 522,560 | `05984ae4f53b22bc3c2d0c08418e67fa2ba3177eb45ccf454c95b4cdac752f22` |
+| `voices/kokoro-voice-zm_yunxia.gguf` | 522,560 | `3bd45f484c54590475dfda4f87d20d7d11645e83bd7f55311c018b0a7f0aeae3` |
+| `voices/kokoro-voice-zm_yunyang.gguf` | 522,560 | `95af161f5da6529abe65cc05d65daa4f84ddbbb5b8695a0edadad7351b13607a` |

README.md

@@ -0,0 +1,183 @@
+---
+language:
+- en
+- es
+- fr
+- hi
+- it
+- ja
+- pt
+- zh
+license: apache-2.0
+library_name: kokoro.cpp
+pipeline_tag: text-to-speech
+base_model: hexgrad/Kokoro-82M
+base_model_relation: quantized
+inference: false
+tags:
+- audio
+- text-to-speech
+- tts
+- kokoro
+- gguf
+- ggml
+- cpp
+- cpu
+- gpu
+- multilingual
+---
+
+# Kokoro-82M for `kokoro.cpp` — F16, Q8_0, and all 54 voices
+
+Reproducible GGUF conversions of the official
+[Hexgrad Kokoro-82M v1.0](https://huggingface.co/hexgrad/Kokoro-82M) checkpoint for
+[**`kokoro.cpp`**](https://github.com/simonfxr/kokoro.cpp), a standalone C/C++ runtime powered by GGML.
+
+> **What is included:** the reference F16 model, a validated Q8_0 model, and
+> every one of the 54 official v1.0 voice packs across all supported languages.
+> No unofficial or third-party voices are mixed into this repository.
+
+## Files
+
+| File | Precision | Size | Notes |
+|---|---:|---:|---|
+| `kokoro-82m-f16.gguf` | F16/F32 | 156.14 MiB | Reference-quality conversion |
+| `kokoro-82m-q8_0.gguf` | Q8_0/F16/F32 | 134.78 MiB | 111 matrix tensors quantized; sensitive/unsupported tensors retained |
+| `voices/kokoro-voice-*.gguf` | F32 | 26.91 MiB total | All 54 official voices; about 510 KiB each |
+| `manifest.json` | — | — | SHA256, size, source revision, and checkpoint provenance |
+| `VALIDATION.md` | — | — | Tensor and fixed-seed audio comparison results |
+
+Voice packs remain F32 because they are small and are indexed style embeddings,
+not matrix-multiplication weights. A model file and one voice file are both
+required for synthesis.
+
+## Quick start with `kokoro.cpp`
+
+```bash
+# Download one model and one voice.
+hf download simonfxr/kokoro.cpp-GGUF \
+  kokoro-82m-q8_0.gguf \
+  voices/kokoro-voice-af_heart.gguf \
+  --local-dir models
+
+# Build the runtime. See the GitHub README for platform/backend options.
+git clone --recursive https://github.com/simonfxr/kokoro.cpp.git
+cd kokoro.cpp
+cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
+cmake --build build -j
+
+# Synthesize 24 kHz mono audio.
+./build/kokoro-cli \
+  -m ../models/kokoro-82m-q8_0.gguf \
+  -v ../models/voices/kokoro-voice-af_heart.gguf \
+  -l en-us \
+  -o output.wav \
+  "Hello from Kokoro dot C P P."
+```
+
+GPU execution is available when `kokoro.cpp` is built with a supported Vulkan,
+Metal, or CUDA backend. GGUF is the container format; llama.cpp and whisper.cpp
+do not implement this Kokoro architecture.
+
+## Languages and voices
+
+Kokoro reports eight languages. Its pipeline distinguishes American and British
+English, resulting in nine language variants. `kokoro.cpp` takes the espeak-ng
+voice shown in the third column, not Kokoro's one-letter pipeline code.
+
+| Language | Kokoro code | `kokoro.cpp -l` | Voices |
+|---|:---:|:---:|---|
+| American English | `a` | `en-us` | 20 |
+| British English | `b` | `en-gb` | 8 |
+| Spanish | `e` | `es` | 3 |
+| French | `f` | `fr-fr` | 1 |
+| Hindi | `h` | `hi` | 4 |
+| Italian | `i` | `it` | 2 |
+| Japanese | `j` | `ja` | 5 |
+| Brazilian Portuguese | `p` | `pt-br` | 3 |
+| Mandarin Chinese | `z` | `cmn` | 8 |
+
+See [`voices/README.md`](voices/README.md) for every voice name and ready-to-copy
+commands. The machine-readable mapping is in
+[`voices/languages.json`](voices/languages.json).
+
+## Conversion and provenance
+
+- Base model: [`hexgrad/Kokoro-82M`](https://huggingface.co/hexgrad/Kokoro-82M)
+- Pinned source revision: `f3ff3571791e39611d31c381e3a41a3af07b4987`
+- Official checkpoint SHA256: `496dba118d1a58f5f3db2efc88dbdc216e0483fc89fe6e47ee1f2c53f18ad1e4`
+- Runtime and converters: [`simonfxr/kokoro.cpp`](https://github.com/simonfxr/kokoro.cpp)
+- Output checksums: [`manifest.json`](manifest.json)
+
+The conversion pipeline fuses PyTorch weight normalization, preserves Kokoro's
+sparse 178-entry IPA vocabulary, maps all 459 runtime tensors, and emits GGUF
+metadata expected by `kokoro.cpp`. Q8_0 quantizes only eligible two-dimensional
+matrix weights whose GGML row width supports 32-element blocks. Convolutional
+kernels remain F16 and rank-one tensors remain F32.
+
+Reproduce these files from the official weights:
+
+```bash
+git clone --recursive https://github.com/simonfxr/kokoro.cpp.git
+cd kokoro.cpp
+python3 -m venv .venv-convert
+. .venv-convert/bin/activate
+pip install -r models/requirements-convert.txt
+./models/convert-original.sh
+```
+
+## Validation
+
+The generated files were checked for tensor names, shapes, dtypes, metadata,
+and source hashes. Both models were loaded by `kokoro.cpp`; F16 and Q8_0 English
+and Q8_0 Spanish synthesis produced valid 24 kHz WAV files.
+
+Against the previously published cstr files:
+
+- The F16 file has the same size and cosine similarity `0.999999999986` over all
+  81,731,256 dequantized elements.
+- Our Q8_0-versus-F16 relative L2 error is `0.00512913`, essentially matching
+  cstr's `0.00512568`.
+- Shared official voices `af_heart`, `ef_dora`, and `ff_siwis` are exactly equal
+  element-for-element.
+- Fixed-seed cstr-F16 versus this F16 output has waveform correlation `0.999920`
+  and log-spectral distance `0.529 dB`.
+
+Full methodology, caveats, and pairwise results are in
+[`VALIDATION.md`](VALIDATION.md). PCM comparisons are phase-sensitive and do not
+replace multilingual listening tests or perceptual metrics.
+
+## Limitations
+
+- Maximum input is 510 raw phoneme tokens because the model adds two boundary
+  tokens to PL-BERT's 512-position context.
+- Phonemization is provided by espeak-ng in `kokoro.cpp`, while the official
+  Python package uses Misaki. Pronunciation can therefore differ.
+- Mandarin tone numbers are not represented in Kokoro's 178-token vocabulary.
+- espeak-ng Japanese kanji coverage is incomplete; pre-phonemized IPA can be
+  supplied when needed.
+- Q8_0 is smaller and validated, but F16 remains the reference choice for
+  maximum fidelity. Lower-bit quantizations are intentionally not published.
+- Voice availability does not imply identical quality across languages. Consult
+  the [official model card](https://huggingface.co/hexgrad/Kokoro-82M) and
+  [official voice notes](https://huggingface.co/hexgrad/Kokoro-82M/blob/main/VOICES.md).
+
+## Intended use
+
+This repository is for local and embedded text-to-speech inference with
+`kokoro.cpp`, including research, accessibility, applications, and deployment
+permitted by the upstream Apache-2.0 license. Users remain responsible for
+appropriate disclosure, consent, and compliance when publishing synthetic
+speech. Do not use generated audio to impersonate people or facilitate fraud.
+
+## License and attribution
+
+The Kokoro-82M weights and official voice packs are Apache-2.0 licensed. The
+GGUF files are numerical conversions of those weights and retain that license.
+`kokoro.cpp` has its own software/dependency licensing details; consult its
+[LICENSE](https://github.com/simonfxr/kokoro.cpp/blob/main/LICENSE) and
+[NOTICE](https://github.com/simonfxr/kokoro.cpp/blob/main/NOTICE) before distributing binaries.
+
+Architecture: StyleTTS 2 / ISTFTNet. Original model, training information,
+datasets, acknowledgements, and citations are documented by
+[Hexgrad](https://huggingface.co/hexgrad/Kokoro-82M).

VALIDATION.md

@@ -0,0 +1,104 @@
+# Official conversion validation
+
+This report records the July 21, 2026 comparison between GGUF files published
+by `cstr` and files generated directly from pinned
+`hexgrad/Kokoro-82M` revision
+`f3ff3571791e39611d31c381e3a41a3af07b4987`.
+
+## Sizes
+
+| Artifact | cstr | Generated here | Difference |
+|---|---:|---:|---:|
+| F16 model | 163,728,096 | 163,728,096 | 0 bytes |
+| Q8_0 model | 141,322,336 | 141,322,752 | +416 bytes |
+| Shared voice pack | 522,560 | 522,560 | 0 bytes |
+| All 54 generated voices | n/a | 28,218,272 | n/a |
+
+The 416-byte Q8_0 difference is container metadata/alignment; both files have
+459 tensors with the same names and the same type counts: 111 Q8_0, 142 F16,
+and 206 F32.
+
+Most generated voices are 522,560 bytes; `jf_gongitsune` is 522,592 bytes
+because its longer metadata name changes GGUF alignment. The cstr voice
+repository has three voices that also occur in the official
+Hexgrad v1.0 voice set: `af_heart`, `ef_dora`, and `ff_siwis`. All three
+published `voice.pack` tensors are element-for-element identical to our F32
+conversions (max error and RMSE both zero). Its four `df_*`/`dm_*` voices are
+for the separate German model and have no counterpart in the official v1.0
+voice set.
+
+## Tensor errors
+
+Every statistic below is computed after dequantization over all 81,731,256
+model elements.
+
+### cstr versus generated here
+
+| Type | Max absolute | RMSE | MAE | Relative L2 | Cosine |
+|---|---:|---:|---:|---:|---:|
+| F16 | 2.89440155e-4 | 3.33034834e-7 | 3.16075518e-9 | 5.34848643e-6 | 0.999999999986 |
+| Q8_0 | 3.76281738e-2 | 1.06066509e-4 | 8.01437548e-6 | 1.70338414e-3 | 0.999998549352 |
+
+For F16, 376 of 459 tensors are exact and 83 differ. The largest difference is
+in `pred.N.2.conv2.weight`. The difference is intentional: this repository
+uses PyTorch's actual weight-normalization formula,
+`v * (g / clamp_min(norm, eps))`. The inherited converter used
+`v * clamp_min(g / norm, eps)`, which changes negative learned `weight_g`
+values. The corrected formula was checked directly against
+`torch._weight_norm` (maximum float32 discrepancy 1.49e-8).
+
+Q8_0 files are independently quantized, so direct Q8-to-Q8 element differences
+include different rounding decisions. Comparing each Q8 model with its own F16
+baseline is more meaningful:
+
+| Pair | Max absolute | RMSE | MAE | Relative L2 |
+|---|---:|---:|---:|---:|
+| cstr Q8_0 versus cstr F16 | 1.91650391e-2 | 3.19161067e-4 | 1.16402241e-4 | 5.12567592e-3 |
+| Our Q8_0 versus our F16 | 1.91955566e-2 | 3.19376048e-4 | 1.16557019e-4 | 5.12912849e-3 |
+
+The quantization-error distributions are therefore nearly identical; our
+global RMSE is 0.067% higher in this comparison.
+
+## Fixed-seed audio output
+
+The four model files synthesized the same sentence with `af_heart`, CPU, four
+threads, length scale 1.0, and `KOKORO_SEED=42`. All outputs had exactly 61,800
+PCM16 samples (2.575 seconds at 24 kHz).
+
+| Reference -> candidate | RMS delta | Relative RMS | Correlation | SNR dB | Spectral convergence | Log-spectral distance dB |
+|---|---:|---:|---:|---:|---:|---:|
+| cstr F16 -> our F16 | 6.2137e-4 | 0.01267 | 0.999920 | 37.94 | 0.00549 | 0.529 |
+| cstr F16 -> cstr Q8_0 | 0.03647 | 0.74362 | 0.72357 | 2.57 | 0.10702 | 3.315 |
+| our F16 -> our Q8_0 | 0.04121 | 0.84010 | 0.64731 | 1.51 | 0.11562 | 3.236 |
+| cstr Q8_0 -> our Q8_0 | 0.03570 | 0.72735 | 0.73548 | 2.77 | 0.10940 | 2.809 |
+
+PCM errors are phase-sensitive: small model changes propagate through the
+source generator and can produce large sample-aligned differences despite much
+smaller magnitude-spectrum differences. These statistics validate
+deterministic execution and expose regressions, but do not by themselves prove
+perceptual equivalence. A release-quality evaluation should add several texts
+per language plus STOI/PESQ or human listening and ASR transcript checks.
+
+## Reproducing comparisons
+
+Tensor comparison:
+
+```bash
+python3 tools/compare_gguf.py reference.gguf candidate.gguf --top 20
+```
+
+Fixed-seed model output comparison:
+
+```bash
+python3 tools/compare_model_outputs.py \
+  --cli build/kokoro-cli \
+  --voice models/generated/voices/kokoro-voice-af_heart.gguf \
+  --model reference=models/kokoro-82m-f16.gguf \
+  --model candidate=models/generated/kokoro-82m-f16.gguf \
+  --reference reference \
+  --text "The documented Q Eight model works." \
+  --seed 42 --output-dir validation/model-output
+```
+
+The output tool preserves every WAV and stderr log and writes `report.json`
+with reference-relative and all pairwise waveform/spectral metrics.

kokoro-82m-f16.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:597926de84f5550e1526ce0abde4e496209d464afc9274d8603d14f3c04d1f67
+size 163728096

kokoro-82m-q8_0.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:61cc0186b3a761bdc31ba5d83b9228e4a72bf974cc5b94c281a5f450e683d2cc
+size 141322752

manifest.json

@@ -0,0 +1,287 @@
+{
+  "source": "hexgrad/Kokoro-82M",
+  "revision": "f3ff3571791e39611d31c381e3a41a3af07b4987",
+  "checkpoint_sha256": "496dba118d1a58f5f3db2efc88dbdc216e0483fc89fe6e47ee1f2c53f18ad1e4",
+  "files": [
+    {
+      "path": "kokoro-82m-f16.gguf",
+      "size": 163728096,
+      "sha256": "597926de84f5550e1526ce0abde4e496209d464afc9274d8603d14f3c04d1f67"
+    },
+    {
+      "path": "kokoro-82m-q8_0.gguf",
+      "size": 141322752,
+      "sha256": "61cc0186b3a761bdc31ba5d83b9228e4a72bf974cc5b94c281a5f450e683d2cc"
+    },
+    {
+      "path": "voices/kokoro-voice-af_alloy.gguf",
+      "size": 522560,
+      "sha256": "6201a548c5cb29862687089a204704b317e77966281c670f4a327379a85014c6"
+    },
+    {
+      "path": "voices/kokoro-voice-af_aoede.gguf",
+      "size": 522560,
+      "sha256": "e8af69ae5eb4a05f55ed4a5916deacc11a694bf9792a7d68948cf7a50b2831a6"
+    },
+    {
+      "path": "voices/kokoro-voice-af_bella.gguf",
+      "size": 522560,
+      "sha256": "63d24d0e5d91cb6cf3bca294a3b8c0b4428aa54ac9b5de42e5ba07f6bd110ea8"
+    },
+    {
+      "path": "voices/kokoro-voice-af_heart.gguf",
+      "size": 522560,
+      "sha256": "c2f44076dfb8f9c098a85d634f6d6b46b038f80e3afdf695ff3b90f6d9ef473f"
+    },
+    {
+      "path": "voices/kokoro-voice-af_jessica.gguf",
+      "size": 522560,
+      "sha256": "58001aae46df272fde02bb25766c61271f7b9523d3e95635ac33d5ef5a4e1837"
+    },
+    {
+      "path": "voices/kokoro-voice-af_kore.gguf",
+      "size": 522560,
+      "sha256": "bfedbada16a3541f13679988e5a82c20e35d65fb09a967aaf57b23d25e97fc52"
+    },
+    {
+      "path": "voices/kokoro-voice-af_nicole.gguf",
+      "size": 522560,
+      "sha256": "04bee67dd22b1eb687e50187c6851db96b6a1ebeee96daf5ec9448427a1bce42"
+    },
+    {
+      "path": "voices/kokoro-voice-af_nova.gguf",
+      "size": 522560,
+      "sha256": "bad32b526d3b4ece8b38dc901bbfcfbfa8f54aa03990042bc5054967f7028501"
+    },
+    {
+      "path": "voices/kokoro-voice-af_river.gguf",
+      "size": 522560,
+      "sha256": "4728ac1a68ba61bb7385b213c67a6f0914b5713dfb3c8146d698a593ab61e4c9"
+    },
+    {
+      "path": "voices/kokoro-voice-af_sarah.gguf",
+      "size": 522560,
+      "sha256": "43cedb17753fd8fae61a1583a81b93a2bf360ccc48c69b9ea2f1a09aa647f0bc"
+    },
+    {
+      "path": "voices/kokoro-voice-af_sky.gguf",
+      "size": 522560,
+      "sha256": "6e4938f82892154eb2793644cb679c8198be863009c0e2e19b529a65af0ad9e3"
+    },
+    {
+      "path": "voices/kokoro-voice-am_adam.gguf",
+      "size": 522560,
+      "sha256": "4cad76e54f38f2ba97811caa97ed220feb7f0973b0fbfe719e0a8b8ca2561634"
+    },
+    {
+      "path": "voices/kokoro-voice-am_echo.gguf",
+      "size": 522560,
+      "sha256": "cf8b334c10d2ded6e45f224bf5d9e1ac49b066a288ec374beaa4283dd80c408b"
+    },
+    {
+      "path": "voices/kokoro-voice-am_eric.gguf",
+      "size": 522560,
+      "sha256": "27c1d63ca2e811439aa14c3c2d93d53bacdf5f2df0a4bb88aaf9fbff7eb3a52f"
+    },
+    {
+      "path": "voices/kokoro-voice-am_fenrir.gguf",
+      "size": 522560,
+      "sha256": "3983d48599b5e219f581ea4fbc186d9181101d282cd2715d521775ba8a6ba882"
+    },
+    {
+      "path": "voices/kokoro-voice-am_liam.gguf",
+      "size": 522560,
+      "sha256": "1dd91a0788afc92cbc822fed6d6ca0e318d96a286312a2167468d805dc73819f"
+    },
+    {
+      "path": "voices/kokoro-voice-am_michael.gguf",
+      "size": 522560,
+      "sha256": "a2b71b49dd6320a2e235f8dfd176b197a2f76d5b32c1e3222efb08f117e78335"
+    },
+    {
+      "path": "voices/kokoro-voice-am_onyx.gguf",
+      "size": 522560,
+      "sha256": "dd905c10ca5ba4463081e9d0744e1d8a267877a1f143b7cec57baa225e82708c"
+    },
+    {
+      "path": "voices/kokoro-voice-am_puck.gguf",
+      "size": 522560,
+      "sha256": "e72ebb9c3599dbff4c3cfa83e5b28708641dbe3e2619bdc0282d8c314437b3ff"
+    },
+    {
+      "path": "voices/kokoro-voice-am_santa.gguf",
+      "size": 522560,
+      "sha256": "8fe64822d3e2a47b6b9dd122f3b901557d709e12cf11c2624524131433798417"
+    },
+    {
+      "path": "voices/kokoro-voice-bf_alice.gguf",
+      "size": 522560,
+      "sha256": "3aafb603c8c20830e5d3b22588eeffec2a95a2e1899fb3cd768067cd16e93e24"
+    },
+    {
+      "path": "voices/kokoro-voice-bf_emma.gguf",
+      "size": 522560,
+      "sha256": "78d519c9bfd34b5e15475169d0757cc77a8a3053d05dce65d3fcb77bf6743448"
+    },
+    {
+      "path": "voices/kokoro-voice-bf_isabella.gguf",
+      "size": 522560,
+      "sha256": "aa896efd783a4d5533c9ddb13ab6464a214ccd7a487b30d5e254e0b5b271d035"
+    },
+    {
+      "path": "voices/kokoro-voice-bf_lily.gguf",
+      "size": 522560,
+      "sha256": "63c2085d71741cc39a0f7044c56f81aa5979e58447003d37c685d9ff1835ae03"
+    },
+    {
+      "path": "voices/kokoro-voice-bm_daniel.gguf",
+      "size": 522560,
+      "sha256": "4fdd111e8668ea12f1b5a8f91a217b1e69b877e1f87da88c79d86216154d490b"
+    },
+    {
+      "path": "voices/kokoro-voice-bm_fable.gguf",
+      "size": 522560,
+      "sha256": "5d870c3b12412cd5139797966ed17913180f523b79c4bc6c3afed1c5b97ec0c1"
+    },
+    {
+      "path": "voices/kokoro-voice-bm_george.gguf",
+      "size": 522560,
+      "sha256": "c72650919593bfeef032b898dfb53ebd192b70ae91081f81697469e6f8914718"
+    },
+    {
+      "path": "voices/kokoro-voice-bm_lewis.gguf",
+      "size": 522560,
+      "sha256": "01b151df68b16e8d9bee3ea497b13d9f0fc8ee14c69a3a95e49515837c6cf3c9"
+    },
+    {
+      "path": "voices/kokoro-voice-ef_dora.gguf",
+      "size": 522560,
+      "sha256": "7fa2a87038c41301363e8e7d97bad2260c20da1a786ec22e0ea954d67dc4c412"
+    },
+    {
+      "path": "voices/kokoro-voice-em_alex.gguf",
+      "size": 522560,
+      "sha256": "bf44594da819e77b4575d9912b8d4b2ab73d67a6a2b17031412a826b98db2b6f"
+    },
+    {
+      "path": "voices/kokoro-voice-em_santa.gguf",
+      "size": 522560,
+      "sha256": "08f06a2e88461d8dff40cc090bbafa72e1d2bb5aa156261ac00613abef2a459f"
+    },
+    {
+      "path": "voices/kokoro-voice-ff_siwis.gguf",
+      "size": 522560,
+      "sha256": "ebeb2847f5a56301af4d61fd31e5c568dfc05b4017694784e86eff9b17d08296"
+    },
+    {
+      "path": "voices/kokoro-voice-hf_alpha.gguf",
+      "size": 522560,
+      "sha256": "e1948214324b9af419ab10053caeb303752f4feee6e641d1dae9a04cdcd57036"
+    },
+    {
+      "path": "voices/kokoro-voice-hf_beta.gguf",
+      "size": 522560,
+      "sha256": "5b750bedc1b0766db556cb29d4fa4376c0cd91399841a72110e4a4036288375a"
+    },
+    {
+      "path": "voices/kokoro-voice-hm_omega.gguf",
+      "size": 522560,
+      "sha256": "a9de65ffa67db1e640af89cbdf0b129ad5e603a8099bec01a98bedd31bdbd2cb"
+    },
+    {
+      "path": "voices/kokoro-voice-hm_psi.gguf",
+      "size": 522560,
+      "sha256": "6c750875b70910475f5ec5cc53ef218bfc464ede6065a29fb66ce4d6aeb3252e"
+    },
+    {
+      "path": "voices/kokoro-voice-if_sara.gguf",
+      "size": 522560,
+      "sha256": "cfc7d3a2ab08df1791ea0e4518c66d0191e91376b1ae437adea826d9556b7b70"
+    },
+    {
+      "path": "voices/kokoro-voice-im_nicola.gguf",
+      "size": 522560,
+      "sha256": "c7e862be2d30a4dba1403b9c6959eb10ab051576faea6bfd45accd8982cdfb52"
+    },
+    {
+      "path": "voices/kokoro-voice-jf_alpha.gguf",
+      "size": 522560,
+      "sha256": "482bf66e90ff6f42c0edf30ec4fb7f7d840347d4b76e8c3ea2bb59932c29f441"
+    },
+    {
+      "path": "voices/kokoro-voice-jf_gongitsune.gguf",
+      "size": 522592,
+      "sha256": "d591f7ccfc63ea980634d4e7f9c2066cb12a74c142be952e68872298cf74fc8a"
+    },
+    {
+      "path": "voices/kokoro-voice-jf_nezumi.gguf",
+      "size": 522560,
+      "sha256": "e2ca00ade95793c508b4352598207a2f324b4b90c5a1725939adbc93a80e65b4"
+    },
+    {
+      "path": "voices/kokoro-voice-jf_tebukuro.gguf",
+      "size": 522560,
+      "sha256": "491505fa90aecae4122f1b9576b232c27486f120a4a64cfdf5e624d9a0d8dc64"
+    },
+    {
+      "path": "voices/kokoro-voice-jm_kumo.gguf",
+      "size": 522560,
+      "sha256": "36af9904115efeb8f7bc950dc652ba96208803e89e871a801bad63cd0279c1f6"
+    },
+    {
+      "path": "voices/kokoro-voice-pf_dora.gguf",
+      "size": 522560,
+      "sha256": "a08314e467100dcb995d520ac0ccc52860d3b0484df7be1a51308a26127e72bd"
+    },
+    {
+      "path": "voices/kokoro-voice-pm_alex.gguf",
+      "size": 522560,
+      "sha256": "8fc600cecf187070752ea27751f9e1383a0b05a0dd585848fc0d561d16a45072"
+    },
+    {
+      "path": "voices/kokoro-voice-pm_santa.gguf",
+      "size": 522560,
+      "sha256": "4bddeba8bc0c05a370805af3ab09180a04100306d5ade588b38c127b6e74688e"
+    },
+    {
+      "path": "voices/kokoro-voice-zf_xiaobei.gguf",
+      "size": 522560,
+      "sha256": "9d6ab39cba27274ace22170c47e1c4bafe556d95413fd2fe3b8d5be1f37c2fbb"
+    },
+    {
+      "path": "voices/kokoro-voice-zf_xiaoni.gguf",
+      "size": 522560,
+      "sha256": "bde67c9715cec5cc416546a1eba44e4e04055a7218f9ea61bfd83f9bf0125c11"
+    },
+    {
+      "path": "voices/kokoro-voice-zf_xiaoxiao.gguf",
+      "size": 522560,
+      "sha256": "f9e39176aae25ddd088102d0f37649a1115526f6818b0bd09002bf5dc35d22e5"
+    },
+    {
+      "path": "voices/kokoro-voice-zf_xiaoyi.gguf",
+      "size": 522560,
+      "sha256": "32912eac11cb36d530d403e26b563beebdba2b74f772ffa5920eaf0aa5d45278"
+    },
+    {
+      "path": "voices/kokoro-voice-zm_yunjian.gguf",
+      "size": 522560,
+      "sha256": "cb2e5965f183db685d5895d55d3f924e41398c9934a3464dd869d8c1261feba8"
+    },
+    {
+      "path": "voices/kokoro-voice-zm_yunxi.gguf",
+      "size": 522560,
+      "sha256": "05984ae4f53b22bc3c2d0c08418e67fa2ba3177eb45ccf454c95b4cdac752f22"
+    },
+    {
+      "path": "voices/kokoro-voice-zm_yunxia.gguf",
+      "size": 522560,
+      "sha256": "3bd45f484c54590475dfda4f87d20d7d11645e83bd7f55311c018b0a7f0aeae3"
+    },
+    {
+      "path": "voices/kokoro-voice-zm_yunyang.gguf",
+      "size": 522560,
+      "sha256": "95af161f5da6529abe65cc05d65daa4f84ddbbb5b8695a0edadad7351b13607a"
+    }
+  ]
+}

voices/README.md

@@ -0,0 +1,35 @@
+# Official Kokoro v1.0 voice packs
+
+This directory contains all 54 F32 voice packs from
+[`hexgrad/Kokoro-82M`](https://huggingface.co/hexgrad/Kokoro-82M), converted without
+quantization for [`kokoro.cpp`](https://github.com/simonfxr/kokoro.cpp). Each GGUF declares the
+`kokoro-voice` architecture and contains one `voice.pack` tensor with GGML shape
+`(256, 1, 510)` (source PyTorch shape `(510, 1, 256)`).
+
+| Language | Kokoro code | `kokoro.cpp -l` | Voices |
+|---|:---:|:---:|---|
+| American English | `a` | `en-us` | `af_alloy`, `af_aoede`, `af_bella`, `af_heart`, `af_jessica`, `af_kore`, `af_nicole`, `af_nova`, `af_river`, `af_sarah`, `af_sky`, `am_adam`, `am_echo`, `am_eric`, `am_fenrir`, `am_liam`, `am_michael`, `am_onyx`, `am_puck`, `am_santa` |
+| British English | `b` | `en-gb` | `bf_alice`, `bf_emma`, `bf_isabella`, `bf_lily`, `bm_daniel`, `bm_fable`, `bm_george`, `bm_lewis` |
+| Spanish | `e` | `es` | `ef_dora`, `em_alex`, `em_santa` |
+| French | `f` | `fr-fr` | `ff_siwis` |
+| Hindi | `h` | `hi` | `hf_alpha`, `hf_beta`, `hm_omega`, `hm_psi` |
+| Italian | `i` | `it` | `if_sara`, `im_nicola` |
+| Japanese | `j` | `ja` | `jf_alpha`, `jf_gongitsune`, `jf_nezumi`, `jf_tebukuro`, `jm_kumo` |
+| Brazilian Portuguese | `p` | `pt-br` | `pf_dora`, `pm_alex`, `pm_santa` |
+| Mandarin Chinese | `z` | `cmn` | `zf_xiaobei`, `zf_xiaoni`, `zf_xiaoxiao`, `zf_xiaoyi`, `zm_yunjian`, `zm_yunxi`, `zm_yunxia`, `zm_yunyang` |
+
+## Download and use a voice
+
+```bash
+hf download simonfxr/kokoro.cpp-GGUF voices/kokoro-voice-ef_dora.gguf --local-dir models
+
+./build/kokoro-cli \
+  -m models/kokoro-82m-q8_0.gguf \
+  -v models/voices/kokoro-voice-ef_dora.gguf \
+  -l es \
+  "Hola, esta es una prueba en español."
+```
+
+Keep the voice and `-l` language consistent. The first letter of each official
+voice name is Kokoro's language code; the second is `f` or `m` for the voice's
+published presentation.

voices/kokoro-voice-af_alloy.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6201a548c5cb29862687089a204704b317e77966281c670f4a327379a85014c6
+size 522560

voices/kokoro-voice-af_aoede.gguf

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

voices/kokoro-voice-af_bella.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:63d24d0e5d91cb6cf3bca294a3b8c0b4428aa54ac9b5de42e5ba07f6bd110ea8
+size 522560

voices/kokoro-voice-af_heart.gguf

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

voices/kokoro-voice-af_jessica.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:58001aae46df272fde02bb25766c61271f7b9523d3e95635ac33d5ef5a4e1837
+size 522560

voices/kokoro-voice-af_kore.gguf

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

voices/kokoro-voice-af_nicole.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:04bee67dd22b1eb687e50187c6851db96b6a1ebeee96daf5ec9448427a1bce42
+size 522560

voices/kokoro-voice-af_nova.gguf

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

voices/kokoro-voice-af_river.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4728ac1a68ba61bb7385b213c67a6f0914b5713dfb3c8146d698a593ab61e4c9
+size 522560

voices/kokoro-voice-af_sarah.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:43cedb17753fd8fae61a1583a81b93a2bf360ccc48c69b9ea2f1a09aa647f0bc
+size 522560

voices/kokoro-voice-af_sky.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6e4938f82892154eb2793644cb679c8198be863009c0e2e19b529a65af0ad9e3
+size 522560

voices/kokoro-voice-am_adam.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4cad76e54f38f2ba97811caa97ed220feb7f0973b0fbfe719e0a8b8ca2561634
+size 522560

voices/kokoro-voice-am_echo.gguf

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

voices/kokoro-voice-am_eric.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:27c1d63ca2e811439aa14c3c2d93d53bacdf5f2df0a4bb88aaf9fbff7eb3a52f
+size 522560

voices/kokoro-voice-am_fenrir.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:3983d48599b5e219f581ea4fbc186d9181101d282cd2715d521775ba8a6ba882
+size 522560

voices/kokoro-voice-am_liam.gguf

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

voices/kokoro-voice-am_michael.gguf

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

voices/kokoro-voice-am_onyx.gguf

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

voices/kokoro-voice-am_puck.gguf

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

voices/kokoro-voice-am_santa.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:8fe64822d3e2a47b6b9dd122f3b901557d709e12cf11c2624524131433798417
+size 522560

voices/kokoro-voice-bf_alice.gguf

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

voices/kokoro-voice-bf_emma.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:78d519c9bfd34b5e15475169d0757cc77a8a3053d05dce65d3fcb77bf6743448
+size 522560

voices/kokoro-voice-bf_isabella.gguf

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

voices/kokoro-voice-bf_lily.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:63c2085d71741cc39a0f7044c56f81aa5979e58447003d37c685d9ff1835ae03
+size 522560

voices/kokoro-voice-bm_daniel.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:4fdd111e8668ea12f1b5a8f91a217b1e69b877e1f87da88c79d86216154d490b
+size 522560

voices/kokoro-voice-bm_fable.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5d870c3b12412cd5139797966ed17913180f523b79c4bc6c3afed1c5b97ec0c1
+size 522560

voices/kokoro-voice-bm_george.gguf

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

voices/kokoro-voice-bm_lewis.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:01b151df68b16e8d9bee3ea497b13d9f0fc8ee14c69a3a95e49515837c6cf3c9
+size 522560

voices/kokoro-voice-ef_dora.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:7fa2a87038c41301363e8e7d97bad2260c20da1a786ec22e0ea954d67dc4c412
+size 522560

voices/kokoro-voice-em_alex.gguf

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

voices/kokoro-voice-em_santa.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:08f06a2e88461d8dff40cc090bbafa72e1d2bb5aa156261ac00613abef2a459f
+size 522560

voices/kokoro-voice-ff_siwis.gguf

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

voices/kokoro-voice-hf_alpha.gguf

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

voices/kokoro-voice-hf_beta.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:5b750bedc1b0766db556cb29d4fa4376c0cd91399841a72110e4a4036288375a
+size 522560

voices/kokoro-voice-hm_omega.gguf

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

voices/kokoro-voice-hm_psi.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:6c750875b70910475f5ec5cc53ef218bfc464ede6065a29fb66ce4d6aeb3252e
+size 522560

voices/kokoro-voice-if_sara.gguf

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

voices/kokoro-voice-im_nicola.gguf

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

voices/kokoro-voice-jf_alpha.gguf

@@ -0,0 +1,3 @@
+version https://git-lfs.github.com/spec/v1
+oid sha256:482bf66e90ff6f42c0edf30ec4fb7f7d840347d4b76e8c3ea2bb59932c29f441
+size 522560

voices/kokoro-voice-jf_gongitsune.gguf

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

voices/kokoro-voice-jf_nezumi.gguf

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