epub_to_audiobook

环境要求

• Python 3 环境（README 使用 python3 命令）
• pip，可安装 requirements.txt 中的依赖
• OpenAI API Key，或 Azure Text-to-Speech 的 KEY 与 REGION
• 如使用 Docker WebUI，需已安装 Docker 与 docker compose

安装与启动步骤

1. 1克隆仓库

   把项目代码下载到本地并进入项目目录，后续所有命令都在该目录执行。

   git clone https://github.com/p0n1/epub_to_audiobook.git
   cd epub_to_audiobook

   复制

2. 2创建虚拟环境

   用 venv 隔离依赖，避免污染系统 Python；Windows 下激活命令不同。

   python3 -m venv venv
   source venv/bin/activate

   复制

3. 3安装依赖

   安装 requirements.txt 中的全部依赖。Python 3.14 需使用仓库中最新的依赖集。

   pip install -r requirements.txt

   复制

4. 4配置 API 密钥

   按所选 TTS 服务设置对应环境变量：OpenAI 用 OPENAI_API_KEY，Azure 需 KEY 与 REGION。

   export OPENAI_API_KEY=sk-xxxxxxxx

   复制

5. 5试运行检查章节

   加 --preview 只打印章节序号、标题与字数，不调用 TTS，可先确认拆分是否正确。

   python3 main.py your_book.epub ./output --preview

   复制

6. 6正式转换有声书

   指定输入 EPUB、输出目录和 TTS 提供方；中文书加 --language zh-CN。

   python3 main.py your_book.epub ./output --tts openai --language zh-CN

   复制

7. 7Docker 启动 WebUI

   先编辑 docker-compose.webui.yml 填入 API 密钥，再启动，适合不想用命令行的用户。

   docker compose -f docker-compose.webui.yml up

   复制

关键配置

如何确认成功

WebUI 启动后浏览器访问 http://localhost:7860 可打开界面；命令行可先跑 python3 main.py -h 确认参数正常，转换完成后输出目录会生成音频文件。

常见问题

注意事项

• --tts 默认值为 azure，用 OpenAI 时务必显式传 --tts openai 并设置 OPENAI_API_KEY。
• Docker WebUI 方式必须先把 API 密钥写入 docker-compose.webui.yml，README 未提供其他配置方式。
• 使用 --worker_count 并行时章节处理顺序可能变化，但不影响最终有声书结果。
• 密钥请通过环境变量或 compose 文件传入，不要写进命令历史或提交到仓库。