← 返回日报
精读 预计 2 分钟

Local, CPU-Friendly, High-Quality TTS (Text-to-Speech) with Kokoro

摘要

文章介绍 Kokoro-82M 模型作为 CPU 友好型高品质 TTS 解决方案,仅 82M 参数、支持英语、普通话、印地语等多语言(约 50 种声音,英文优化为主),实现隐私保护。视频展示 GPU 全留给 LLM 的机器上纯 CPU 运行 TTS 效果。提供 Kokoro-FastAPI 容器镜像(约 5GB,含预下载语音模型)Docker/Podman 启动命令,容器启动后在 localhost:8880/web 提供简易 Web UI(可输入文字生成并自动播放音频),同时兼容 OpenAI Speech API。示例给出 JavaScript 与 Python 客户端代码(GitHub 仓库 speak)。可通过 TTS VOICE 环境变量切换声音。测试数据:短段落生成时间 i7-4770K 4.7 秒、Apple M2 Pro 4.5 秒、AMD Ryzen 7 8745HS 1.5 秒。另推荐 Speaches(含 Whisper STT)作为备选方案,可与本地 LLM 结合实现语音回复。

荐读理由

用 Kokoro-FastAPI Docker 容器拉起本地 TTS 服务,CPU 完全跑通,支持 OpenAI 语音 API 接口兼容,Kokoro 82M 参数模型就能出多语 50 音色语音,无需 GPU 占位,配合本地 LLM 就能听答案不看字

原文

Local, CPU-Friendly, High-Quality TTS (Text-to-Speech) with Kokoro

Just a few years ago, realistic local speech generation seemed unimaginable. Today, its quality is exceptional and, crucially, it delivers these results without compromising privacy.

The video above showcases audio generated from a sample text, running entirely on the local machine previously discussed in the GTX 1080 Ti for Local LLM article. While this machine has a dedicated GPU, the GPU is fully reserved for LLM inference and the speech synthesis is powered entirely by the CPU.

The model used is Kokoro, which, despite having only 82M parameters, produces realistic speech in multiple languages including English, Mandarin, and Hindi. It provides around 50 distinct voices, primarily optimized for English.

There are several ways to set up a server for Kokoro. The simplest method involves using a pre-made container image called Kokoro-FastAPI, which includes pre-downloaded voice models. Because of that, the container image is rather large, at about 5 GB in size.

To launch the container using Docker or Podman, use the following command:

podman run -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-cpu

To quickly verify that it runs correcly, the container serves a simple web UI at localhost:8880/web. Here you can generate (and automatically play) an audio given some text.

Kokoro web UI

In addition to the simple web UI, this container also serves a TTS interface compatible with the OpenAI speech API, making it easy to adapt existing programs that already use the OpenAI speech API. To facilitate a quick test, sample code in both JavaScript and Python is available at github.com/remotebrowser/speak. Cloning this repository will enable you to follow the subsequent demonstration.

For JavaScript:

export TTS_API_BASE_URL=http://127.0.0.1:8880/v1
./speak.js "Good morning! How are you today?"

For Python, the command is very similar:

export TTS_API_BASE_URL=http://127.0.0.1:8880/v1
./speak.py "Good morning! How are you today?"

The generated audio will be saved as an MP3 file. If SoX or Sound eXchange (see sox.sf.net for details) is installed on your machine, the audio will also play back automatically.

You can also select a different voice by setting the TTS_VOICE environment variable:

export TTS_API_BASE_URL=http://127.0.0.1:8880/v1
export TTS_VOICE="am_eric"
./speak.js "Good morning! How are you today?"

A complete list of available voices can be found on the official Kokoro project page: huggingface.co/hexgrad/Kokoro-82M/blob/main/VOICES.md.

How fast is the synthesis? Here are some measurements using the am_eric voice on a short test paragraph:

Jupiter is the largest and most massive planet in our solar system. This gas giant, made mostly of hydrogen and helium, is known for its Great Red Spot—a massive storm observed for centuries.

The following list summarizes the generation time (best of 3 runs) across different CPUs:

  • Intel Core i7-4770K: 4.7 seconds

  • Apple M2 Pro: 4.5 seconds

  • AMD Ryzen 7 8745HS: 1.5 seconds

The first CPU in the list was released 12 years ago. If that ancient CPU can do the job just fine, you know that this is a highly capable TTS system.

Finally, for an alternative OpenAI-compatible containerized TTS service, consider Speaches (speaches.ai). Unlike Kokoro-FastAPI, Speaches requires you to explicitly download voice weights via its API, as they are not bundled in the container image. However, Speaches offers an advantage by including Whisper, OpenAI’s renowned high-quality Speech-to-Text (STT) system. If your application needs both TTS and STT functionality, Speaches could be your one-stop solution.

When combined with a local LLM, a speech synthesis system like this allows you to enjoy listening to LLM answers instead of reading them!

Note: This article originally appeared on the Remote Browser Substack.

Hacker News · 191 赞 · 36 评 讨论 → 阅读原文 →

这条对你有帮助吗?