kokoro-tts

环境要求

• Python 3.11-3.12（不支持 Python 3.13 及以上）
• pip 或 uv（README 推荐 uv）
• 如需从源码安装，需已安装 git
• 可选：GPU 环境以获得加速（README 提到支持 GPU）

安装与启动步骤

1. 1确认 Python 版本

   先检查本机 Python 版本，必须为 3.11 或 3.12，3.13+ 当前不被支持。

   python --version

   复制

2. 2从 PyPI 安装

   README 推荐的方式，使用 uv 或 pip 全局安装 kokoro-tts，二选一执行即可。

   uv tool install kokoro-tts
   pip install kokoro-tts

   复制

3. 3验证命令可用

   安装后运行帮助命令，能正常打印用法说明即安装成功。

   kokoro-tts --help

   复制

4. 4源码克隆安装

   不想用 PyPI 时，克隆仓库后进入目录，用 uv 创建虚拟环境并以可编辑模式安装。

   git clone https://github.com/nazdridoy/kokoro-tts.git
   cd kokoro-tts
   uv venv
   uv pip install -e .

   复制

5. 5pip 方式本地安装

   没有 uv 时，用 Python 自带 venv 建环境并安装；Windows 激活命令见 README 注释。

   python -m venv .venv
   source .venv/bin/activate
   pip install -e .

   复制

6. 6不安装直接运行

   只装依赖不安装包，然后用 uv run -m kokoro_tts 或 python -m kokoro_tts 运行。

   python -m venv .venv
   source .venv/bin/activate
   pip install -r requirements.txt

   复制

7. 7文本转语音

   把文本文件转为音频，可指定语速、语言和音色。本地安装方式需用 uv run kokoro-tts 或先激活虚拟环境。

   kokoro-tts input.txt output.wav --speed 1.2 --lang en-us --voice af_sarah

   复制

关键配置

如何确认成功

运行 kokoro-tts --help 能正常输出帮助信息，即表示安装成功。

常见问题

注意事项

• README 中 Method 2（从 Git 安装）的命令正文被截断，此处未还原，请以官方仓库最新说明为准。
• 完整命令行参数（如音色混合、章节拆分、MP3 输出等）未在节选中列出，请用 kokoro-tts --help 查看实际参数。
• Windows 激活虚拟环境请用 .venvScriptsctivate，而非 source 命令。
• 运行时可能需要下载模型权重，首次执行会耗时并有网络要求。