alexandria-audiobook

环境要求

• Docker（含 docker compose）
• NVIDIA GPU 与 NVIDIA Container Toolkit
• 已启动的 LLM 服务：LM Studio（http://localhost:1234/v1）、Ollama（http://localhost:11434/v1
• 首次使用会下载 TTS 模型，需要留出磁盘空间与网络带宽

安装与启动步骤

1. 1克隆项目仓库

   把 Alexandria 源码拉到本地，随后进入项目目录，所有后续命令都在该目录内执行。

   git clone https://github.com/Finrandojin/alexandria-audiobook.git
   cd alexandria-audiobook

   复制

2. 2准备 LLM 服务

   Alexandria 自身不含 LLM，必须先用本地或云端 LLM 服务；用 Ollama 时可直接拉取 qwen3 模型并启动服务。

   ollama run qwen3

   复制

3. 3启动 Docker 容器

   用 compose 构建并启动服务；需已装好 NVIDIA Container Toolkit，否则 GPU 不可用。

   docker compose up --build

   复制

4. 4打开 Web 界面

   容器启动完成后，在浏览器访问本地面板，即可进入 Setup 标签页配置 LLM 与 TTS 连接。

5. 5配置 LLM 与 TTS

   在 Setup 标签页填写 LLM 服务地址，选择 TTS 模式（local 内置引擎或 external Gradio 服务）和设备。

6. 6生成脚本并导出

   按 5 步核心流水线先生成脚本，再渲染语音，最后导出 MP3、M4B 或 Audacity 多轨工程。

关键配置

如何确认成功

浏览器打开 http://localhost:4200 能正常显示 Web 界面，并在 Setup 页成功连接 LLM 与 TTS。

常见问题

注意事项

• Docker 部署必须安装 NVIDIA Container Toolkit，否则容器无法使用 GPU。
• 用户数据通过 bind mount 保存在项目目录，迁移或备份时记得连同该目录一起处理。
• README 建议提问前先通读 README 与官方 Wiki，多数常见问题已有答案。
• README 未给出 Pinokio 与 Colab 的详细步骤，可按仓库内对应说明文件操作。