abogen

把电子书一键变成带字幕的有声书，听读两不误。

abogen 是一个将电子书（EPUB、PDF 和纯文本）自动转换为带同步字幕的有声书的开源工具。它解决了传统有声书制作成本高、周期长的问题，让普通用户也能快速将阅读材料转化为可听的音频。其核心能力包括：解析多种电子书格式，提取章节和正文；利用 Kokoro TTS 等语音合成引擎生成自然语音；自动生成与音频同步的字幕文件，方便跟读或校对。项目基于 Python 构建，技术栈轻量，支持本地运行，适合个人使用或内容创作者批量生产有声内容。

开源 free 音频音乐

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 6042

维护状态较活跃

是否开源是

定价模式 free

项目数据

分类音频音乐

开发团队denizsafak

所属国家

官网地址

GitHubhttps://github.com/denizsafak/abogen

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型audiobook,audiobooks,content-creation,content-creator,ebook,epub,epub-converter,kokoro,kokoro-82m,kokoro-tts,llm,media-generation,narrator,speech-synthesis,subtitles,text-to-audio,text-to-speech,tts,voice-conversion,voice-synthesis

GitHub 星标★ 6042

30天Star增速

HF 下载量

上线时间2025-04-24 00:00:00

最近更新2026-09-22 00:00:00

维护状态较活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数3

使用教程

难度：入门约 10 分钟部署方式：本地安装 7 步

环境要求

Python 环境（pip / pip3，Windows 一键脚本会自动安装 Python）
系统需先安装 espeak-ng（Windows 下载 .msi，macOS 用 brew，Linux 用包管理器）
pip install abogen 可从 PyPI 获取，无需编译
macOS 用户需额外安装 Kokoro 开发版以启用 MPS 支持
AMD GPU 用户需改装 ROCm 版 torch

安装与启动步骤

1安装 espeak-ng（Win）

访问 espeak-ng 最新 release 页面，下载并双击运行 .msi 安装文件，这是所有平台的必备依赖。
2安装 espeak-ng（mac/Lin

macOS 用 brew，Linux 按发行版选择 apt、pacman 或 dnf 命令安装 espeak-ng。
```
brew install espeak-ng
sudo apt install espeak-ng
sudo pacman -S espeak-ng
sudo dnf install espeak-ng
```
3安装 abogen

通过 PyPI 安装 abogen 主程序；Linux 或 macOS 上若没有 pip 命令可改用 pip3。
```
pip install abogen
pip3 install abogen
```
4macOS 补装 Kokoro

macOS 安装 abogen 后，还需安装 Kokoro 开发版，才具备 MPS 加速支持。
```
pip3 install git+https://github.com/hexgrad/kokoro.git
```

5AMD 显卡换装 torch

使用 AMD GPU 的 Linux 用户先卸载已有 torch，再安装 ROCm 6.4 nightly 版本。

pip3 uninstall torch
pip3 install --pre torch torchvision torchaudio --index-url https://download.pytorch.org/whl/nightly/rocm6.4

6启动图形界面

在终端执行 abogen 即可打开桌面 GUI；Windows 脚本安装的用户也可用桌面快捷方式启动。
```
abogen
```
7转换电子书

在界面里拖入文件，设置语速、音色、字幕样式与输出格式，指定保存位置后点 Start 开始生成。

关键配置

配置项	必填	说明	示例
`Input Box`	是	拖放或选择要转换的文件，也支持内置文本编辑器输入	`book.epub`
`Speed`	否	调节语速，可选范围 0.1x 到 2.0x	`1.0x`
`Select Voice`	否	音色代码，首字母为语言、第二个字母为性别（m/f）	`af`
`Generate subtitles`	否	字幕切分方式，可按行、句、词数或高亮生成	`Sentence`
`Output voice format`	否	输出音频格式，支持 WAV、FLAC、MP3、OPUS 与 M4B	`MP3`
`Output subtitle format`	否	输出字幕格式，支持 SRT 及多种 ASS 布局	`SRT (standard)`

如何确认成功

在终端执行 abogen 后弹出 Abogen Desktop GUI 窗口，即表示安装与启动成功。

常见问题

Q：提示 CUDA GPU is not available. Using CPU 怎么办？

A：README 中有专门章节说明该警告的修复方法，按其中步骤检查 CUDA 与 torch 的安装配置即可恢复 GPU 加速。

Q：Linux 提示 abogen-cli 安装在 .local/bin 不在 PATH 中？

A：README 提供了对应章节 How to fix WARNING: The script abogen-cli is installed in PATH error in Linux，按其中说明把该目录加入 PATH 环境变量。

Q：安装时报 No matching distribution found 怎么办？

A：README 有专门章节说明该错误的处理方式，通常与 Python 版本或 pip 源不匹配有关，请对照该章节排查。

Q：Windows 报 WinError 1114 DLL 初始化失败？

A：README 有专门章节说明该错误的解决办法，建议按其中步骤重新配置依赖后再次安装。

Q：AMD 显卡能用吗？

A：可以，README 提供了 ROCm 版 torch 的安装命令，该支持由社区贡献者实现，按命令重装 torch 即可。

注意事项

espeak-ng 是所有平台的必备前置依赖，务必先安装完成再装 abogen。
Windows 用户可下载 ZIP 解压后双击 WINDOWS_INSTALL.bat 一键安装，无需单独安装 Python，但仍需装 espeak-ng。
macOS 用户在 pip 安装 abogen 之后，必须再装 Kokoro 开发版才有 MPS 支持。
Linux 与 macOS 上 pip 命令可能不可用，请改用 pip3。

核心亮点

支持 EPUB、PDF 和 TXT 多种格式，输入灵活
集成 Kokoro TTS，生成语音自然度高
自动生成同步字幕，便于跟读和校对

不足之处

依赖外部 TTS 模型，首次配置稍复杂
长文本处理速度可能较慢
文档/社区待观察

适用场景

个人将电子书转为有声书，通勤或运动时听
内容创作者快速生成带字幕的音频内容
教育场景中为教材生成可听的辅助材料

替代项目

Audiobook Maker、Calibre (配合 TTS 插件)、NaturalReader

项目介绍

abogen 是音频音乐领域的开源项目，由 denizsafak 开发，2025 年首次发布。

在全站 13,014 个收录项目中，它的 GitHub 星标数（6,042）位列前 8%，在音频音乐分类的 738 个项目里位列前 5%。

近 44 天，它的 GitHub 星标从 5,628 增加到 6,042，净增 414。

项目保持着较活跃的维护节奏，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：个人将电子书转为有声书，通勤或运动时听。同类可对比的替代方案包括 Audiobook Maker、Calibre (配合 TTS 插件)、NaturalReader。

上一篇：silero-models

下一篇：Kokoro-FastAPI