Skip to content
Audio

Kokoro-82M-CoreML-Masked

быстрый синтез речи для iOS и macOS без артефактов

3 min readupdated

Компактная TTS-модель (преобразование текста в речь) Kokoro-82M от hexgrad получила обновлённый end-to-end экспорт в формат CoreML от автора milestonemade. Обычные CoreML-сборки вынуждены дополнять короткие фразы пустыми токенами (паддингом) до фиксированной длины, из-за чего двунаправленные LSTM-слои считывают пустоту и делают речь торопливой и «дрожащей». В этой версии LSTM удерживают состояние на пустых шагах, поэтому длительность звуков и интонация полностью совпадают с оригинальной моделью на PyTorch. Релиз пригодится разработчикам под iOS 18+ и macOS 15+, которым нужен локальный офлайн-синтез голоса с естественной подачей.

Ключевые особенности

  • Полный пайплайн в одном вызове: BERT, предсказание длительности, выравнивание, просодия и декодер объединены в единый граф CoreML, выдающий аудио с частотой 24 кГц.
  • Четыре готовых варианта под разную длину фраз: доступны модели с окнами на 5 секунд (fp32 — 327 МБ, fp16 — 233 МБ), 10 секунд (fp16 — 234 МБ) и 15 секунд (fp16 — 236 МБ).
  • Большой набор голосов: в репозиторий включены 54 готовых пресета голосов на 10 языках, а также словари и G2P-модели (перевод текста в фонемы).
  • Точное совпадение с PyTorch: предсказанные длительности фонем идентичны оригиналу, а спектральная корреляция для fp16-версий достигает 0.996–0.9985.

Что можно сделать

  • Встроить офлайн-озвучку в iOS- или macOS-приложение: использовать библиотеку speech-swift для локальной генерации речи без отправки данных в облако.
  • Сделать отзывчивого голосового ассистента: взять быструю версию kokoro_masked_5s_fp16, которая генерирует первый 5-секундный фрагмент примерно за 200 мс на CPU Apple Silicon.
  • Озвучивать длинные предложения без склеек: переключаться на вариант kokoro_masked_15s_fp16, чтобы синтезировать до ~10 секунд речи за один проход с единым интонационным контуром.

Пример

import KokoroTTS

let tts = try await KokoroTTSModel.fromPretrained(
    modelId: "milestonemade/Kokoro-82M-CoreML-Masked",
    modelFile: "kokoro_masked_5s_fp16",
    computeUnits: .cpuOnly)
let audio = try tts.synthesize(text: "Hello world, this is a Kokoro test.", voice: "af_heart")
Подробнее • В слепых тестах на коротких фразах kokoro_masked_5s_fp16 обошла прошлую лучшую сборку kokoro_5s в 6 из 8 пар, а 15-секундная версия выиграла 6 из 6 на длинных предложениях.
• Скорость одного прохода на CPU Apple Silicon: ~200 мс (5s fp16), ~270 мс (5s fp32), ~0.6 с (10s fp16) и ~0.9–1.4 с (15s fp16).
• Ограничения: fp16-модели нужно запускать строго с .cpuOnly (на Neural Engine первая компиляция занимает ~70 минут, а работа в 5 раз медленнее); каждый проход всегда обсчитывает всё окно целиком; у версий 5s и 10s fp16 в начале прохода есть короткий всплеск шума (первые 25 мс нужно обнулять).
• Требования: iOS 18+ или macOS 15+; веса и голоса распространяются под лицензией Apache-2.0, скрипты экспорта — MIT.
Discuss Telegram 1

Will it run?

Runs in BF16

Fits without quantisation.

  • BF16weights 0.3 GB · ready files0.8 GB
  • FP8 / INT8recommendedweights 0.2 GB0.7 GB
  • 4-bitweights 0.1 GB0.6 GB

Tip: go 8-bit.FP8 / INT8 is within about a percent of full precision in quality, takes half the memory and runs faster on RTX 40/50 and H100. Full precision only pays off for fine-tuning.

What to get for this model

Massed ComputeOpen Massed Compute

Your own GPU: FP8 / INT8 — from RTX 2060 · BF16 — from RTX 2060

Massed Compute hourly prices, November 2026. The discounted price applies with the coupon at checkout.

Estimate: weights plus working memory. Long videos, high resolutions and long contexts need more.

Run it on Massed Compute

The script downloads the model to the rented machine. How to run it is in the model card.

  1. 1. Rent a machine with a fitting GPU

    Open Massed Compute
  2. 2. Paste the script into the machine's terminal

    Connect over SSH (the Massed Compute panel shows the command) or open a terminal on the machine's desktop.

    HF_TOKEN / CIVITAI_TOKENThe script starts with token lines: paste yours between the quotes. The Hugging Face token is for gated models, the Civitai one for Civitai models.

    # milestonemade/Kokoro-82M-CoreML-Masked
    mkdir -p ~/models
    curl -LsSf https://astral.sh/uv/install.sh | sh
    source "$HOME/.local/bin/env"
    uv tool install "huggingface_hub[cli]"
    hf download milestonemade/Kokoro-82M-CoreML-Masked --local-dir ~/models/Kokoro-82M-CoreML-Masked
    # The model is in ~/models. How to run it is in the model card (link above).
  3. 3. Use it

    The model is in ~/models. How to run it is in the model card (link above).

Stop the machine in the panel when you are done: it bills by the minute while it runs.

How to speed it up

Picked for this model type. Choose your hardware above to see what fits you exactly.

  • FlashAttention 44.0.0b40from November 18, 2026new release

    fastest exact attention on B200

    Kernels for Blackwell (beta). Exact attention without quantisation — fine for everything, LLMs included.

    How to enable: pip install flash-attn-4; vLLM and SGLang pick it up themselves.

    Earlier generations (2)
    • FlashAttention 3 — The Hopper (H100/H200) version with FP8.
    • FlashAttention 2 — The standard for RTX 30/40/50 and A100: exact attention without the memory cost of long contexts.
  • torch.compile2.15.0from October 28, 2026new release

    10–30% for free

    Compiles the model for your GPU. Slower first run, faster afterwards.

    How to enable: model = torch.compile(model); in ComfyUI the TorchCompileModel node.

Model family

  1. StyleTTS2-LJSpeechfamily root
  2. Kokoro-82M
  3. Kokoro-82M-CoreML-Masked

New posts about versions of StyleTTS2-LJSpeech (quants, finetunes, LoRAs) will show up under the bell.

Quantised versions 3All on Hugging Face
Fine-tunes 12All on Hugging Face

About the model

milestonemade/Kokoro-82M-CoreML-Masked
Author
milestonemade
Category
Audio
Released
Posted

On NeyroLearn

Hugging Face

01

Ask AI about this model

Answered by Gemini 4 · the chat is kept only in this tab

Comments