10分钟装好Alexandria:Pinokio一键部署AI有声书生成器完整教程

发布时间:2026/10/15 16:23:00

10分钟装好Alexandria:Pinokio一键部署AI有声书生成器完整教程 【免费下载链接】alexandria-audiobookAI-powered multi-voice audiobook generator — LLM script annotation, voice cloning, voice design, LoRA training, per-line style control, and export to MP3, chaptered M4B, or Audacity multi-track. Built on Qwen3-TTS.项目地址https://gitcode.com/gh_mirrors/al/alexandria-audiobook点击查看免费下载Alexandria 是一款开源的AI 有声书生成器能利用 LLM 自动标注剧本、为每个角色分配独立声音并把小说或书籍合成为多角色配音的有声书支持导出 MP3、带章节的 M4B、Audacity 多轨工程。借助Pinokio 一键部署普通用户无需手动配置 Python 环境10 分钟即可完成 Alexandria 安装并启动 Web 界面。一、Alexandria 能做什么简单来说上传一本书.txt / .md / .epubAI 自动完成剧本分角色 → 配声音 → 合成音频 → 合并导出的全流程。核心能力一览能力说明 自动剧本标注LLM 将书籍解析为带说话人、对话、语气指令的结构化剧本 多角色配音9 种预置声音、声音克隆5-15 秒参考音频即可、文字描述设计新声音 逐行风格控制每一句都可单独设置语气/情感指令并可单独重新生成 内置 TTS 引擎基于 Qwen3-TTS 本地运行无需额外部署语音服务 灵活导出MP3 整书、带章节 M4BAudiobookshelf / Apple Books 可播、Audacity 分轨 WAV 进阶玩法LoRA 声音微调训练、数据集构建器、角色人声一键批量生成想快速了解声音类型与批量生成的细节可参考仓库中的 lora.md 与 VOICE_REFERENCE.md。二、安装前准备硬件与软件要求在点击 Install 之前先确认你的电脑满足以下条件避免安装后无法使用硬件要求项目最低配置推荐配置GPU 显存8 GB16 GB 以上内存8 GB16 GB磁盘空间约 20 GB环境 模型权重 音频工作区—系统兼容性常见平台速查✅ NVIDIA 显卡Windows / Linux完整 GPU 加速驱动 550✅ AMD 显卡LinuxROCm 6.3自动应用优化⚠️ AMD 显卡Windows/ Apple Mac仅 CPU 模式可运行但速度较慢软件依赖一个 LLM 服务器Alexandria 本身不含 LLM需要通过 API 连接一个LLM 服务默认地址适用场景LM Studiohttp://localhost:1234/v1本地推荐可加载 Qwen3 等模型Ollamahttp://localhost:11434/v1本地轻量方案OpenAI APIhttps://api.openai.com/v1云端服务 脚本生成阶段推荐非思考链模型Qwen3、Gemma3、Qwen2.5、Llama 3.1/3.2 等JSON 输出更稳定。三、Pinokio 一键安装步骤Pinokio 是一个AI 应用一键安装器Alexandria 的仓库里自带了完整的 Pinokio 脚本pinokio.json、install.js、start.js、pinokio.js安装过程几乎零配置。第 1 步安装 Pinokio到 Pinokio 官网下载安装包Windows / macOS / Linux 均支持安装后启动它。第 2 步添加 Alexandria在 Pinokio 中点击Download粘贴仓库地址https://gitcode.com/gh_mirrors/al/alexandria-audiobook即可把 Alexandria 添加到应用列表。第 3 步点击 Install 安装依赖点击 Install 后install.js 会自动完成以下工作清理uv缓存在app目录创建 Python 虚拟环境python -m venv env安装 app/requirements.txt 中的全部依赖 qwen-tts通过 torch.js 自动安装带 CUDA 支持的 PyTorchNVIDIA 显卡会附带 flash attention 加速第 4 步点击 Start 启动 Web 界面start.js 会运行python app.py启动 FastAPI 服务默认端口4200见 app/app.py服务地址打印出来后Pinokio 会自动出现Open Web UI按钮点击即可打开浏览器界面。至此Alexandria 已经装好了 ✅四、首次启动必读4 个容易踩的坑第一次运行 Alexandria以下 4 点能帮你少走很多弯路1. 先启动 LLM 服务器再生成剧本如果在 LLM 未运行的情况下点击 Generate Script生成会直接失败。请确认 LM Studio / Ollama 已启动且模型名称填写正确。2. 首次生成语音会下载约 3.5 GB 模型TTS 模型不包含在安装包里首次生成音频时自动下载每个模型变体约 3.5 GB只下载你实际使用的变体下载在后台进行进度请看 Pinokio 侧栏的 Terminal此时 Web UI 看起来卡住是正常现象它只是在等下载完成下载中断后重启应用即可断点续传国内网络提示如下载缓慢可将环境变量HF_ENDPOINT设置为https://hf-mirror.com后再启动或在 start.js 的env字段中添加env: { HF_ENDPOINT: https://hf-mirror.com }。3. 首批生成有额外预热时间每个会话的第一批生成比后续慢AMD GPU 的 MIOpen 自动调优30-60 秒、torch.compile编解码器编译30-60 秒之后批量解码快 3-4 倍。这是预期行为预热完成后速度会稳定。4. 出问题了先翻 Pinokio 终端Web UI 只显示高层状态详细日志在 Pinokio 侧栏的 Terminal模型加载、下载进度、显存估算、错误信息都在这里。UI 里静默失败时终端会告诉你真因。五、10分钟生成第一本有声书界面分为5 步核心流水线Setup → Script → Voices → Editor → Result和高级工具Designer / Dataset / Training。新手只需走完 5 步核心流程第 1 步 Setup设置LLM Base URLhttp://localhost:1234/v1LM Studio或http://localhost:11434/v1OllamaLLM API Key本地服务填localLLM Model Name你加载的模型名如qwen2.5-14bTTS Mode选local内置引擎推荐点击Save Configuration保存第 2 步 Script剧本选择书籍文件.txt / .md / .epubepub 会自动转纯文本点击Generate Annotated ScriptLLM 会把全文切分为带说话人标签和语气指令的剧本可选点击Review Script跑一遍二次校验自动修复说话人归属错误、归属标签混入对白等常见问题提示词见 review_prompts.txt生成提示词见 default_prompts.txt均可热更新第 3 步 Voices声音每个角色一张声音卡片四种声音类型可选类型特点Custom Voice最简单9 种预置声音 角色风格描述Clone Voice5-15 秒参考音频克隆任意声音LoRA Voice自训练声音适配器身份最稳定Voice Design文字描述实时生成声音适合配角⭐ 偷懒秘诀点击Generate PersonasLLM 会自动分析剧本、为每个角色生成声音描述并分配克隆声音一键完成全员配音。第 4 步 Editor编辑器Render Pending批量生成音频推荐 Batch (Fast) 模式 开启 Compile Codec吞吐可达实时速度的 3-6 倍任意一行可内联修改文本、说话人、语气指令后单独重新生成满意后点击Merge All合并成完整有声书第 5 步 Result结果浏览器内直接试听然后按需下载MP3整本合并音频M4B带章节标记Audiobookshelf / Apple Books / VLC 等播放器可用Export to Audacity按说话人分轨的 WAV LOF 工程 标签一键进 Audacity 精修六、不想装本地环境还有其他两种方式方式 BGoogle Colab零安装没有 GPU 或系统不兼容仓库提供了 alexandria_colab.ipynb可直接在浏览器里用免费 T4 GPU 运行 AlexandriaWeb UI 通过 ngrok 隧道访问详细说明在 notebook 内。方式 CDockerNVIDIA GPU适合服务器部署或自动化流水线git clone https://gitcode.com/gh_mirrors/al/alexandria-audiobook.git cd alexandria-audiobook docker compose up --build依赖 Dockerfile 与 docker-compose.yml启动后访问http://localhost:4200。TTS 模型首次使用时自动下载并缓存到 Docker 卷用户数据通过挂载持久化到项目目录。七、日常维护与常见问题速查更新与重置Pinokio 菜单由 pinokio.js 定义内置了完整维护入口Update执行 update.js自动git pull后重装依赖Reinstall重新执行 install.js 修复环境Reset执行 reset.js停止服务并清理剧本、声音配置、已生成的有声书等运行产物Open Voicelines直接打开单独语音行输出目录常见问题快速排查问题解决方案剧本生成失败确认 LLM 服务器在运行、模型名与已加载模型一致思考链模型请在 Banned Tokens 添加think标签片段模型下载慢/失败设置HF_ENDPOINThttps://hf-mirror.com镜像注册免费 Hugging Face 账号并设置HF_TOKEN显存不足 / OOM降低Parallel Workers与Max Chars/Batch关闭其他占用 GPU 的程序生成速度慢开启Compile Codec、提高Parallel Workers、使用 Batch (Fast) 模式MP3 损坏仅 428 字节Conda 版 ffmpeg 缺少 MP3 编码器执行conda install -c conda-forge ffmpeg显存能力参考可用显存能做什么8 GB单模型、小批量2-5 块16 GB舒适使用批量 10-20 块24 GB全速运行批量 40-60 块 编解码器编译到这里Alexandria 的 Pinokio 一键部署就全部完成了装 Pinokio → 添加仓库 → Install → Start配合一个本地 LLM 服务你就可以把自己的小说变成多角色 AI 有声书了。更多深度内容声音类型详解、LoRA 训练、批量生成调优可继续查阅仓库内的中文文档 README_CN.md。赞分享【免费下载链接】alexandria-audiobookAI-powered multi-voice audiobook generator — LLM script annotation, voice cloning, voice design, LoRA training, per-line style control, and export to MP3, chaptered M4B, or Audacity multi-track. Built on Qwen3-TTS.项目地址https://gitcode.com/gh_mirrors/al/alexandria-audiobook点击查看免费下载相关推荐一键部署AI有声书生成神器ebook2audiobook容器化全攻略想不想用一条命令就把电子书变成专业级有声书ebook2audiobook这个开源神器让你轻松实现这个梦想这个基于AI的电子书转有声书工具支持1100多种语言AI 应用语音音频本地部署革命性AI代理编排系统oh-my-openagent智能任务委派架构深度解析革命性AI代理编排系统oh my openagent智能任务委派架构深度解析 在当今AI辅助开发工具激烈竞争的时代oh my openagent以其革命性的人工智能AI Agent代码智能体多智能体MCP ClientsAgent 编排网盘直链下载助手八大网盘直链解析与获取指南网盘直链下载助手八大网盘直链解析与获取指南 网盘直链下载助手LinkSwift是一个基于 JavaScript 的网盘直链解析脚本可解析文件真实下载地址前端创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
延伸阅读

更多相关文章

2026/10/15 16:23:00

让Continuwuity支持语音通话:LiveKit与TURN服务器搭建全攻略

【免费下载链接】continuwuity A community-driven Matrix homeserver 项目地址: https://gitcode.com/gh_mirrors/co/continuwuity 点击查看 免费下载 Continuwuity 是一款社区驱动的开源 Matrix homeserver,但默认开箱并不带语音/视频通话能力。这篇完…

2026/10/15 17:13:26

STM32F4 移植 uCOS-II 实战:从裸机到 RTOS 的完整工程指南

简介:这份资源是面向嵌入式开发者的STM32F4移植UCOS_II完整工程,基于STM32F407ZGT6与Keil μVision环境,解决实时操作系统在Cortex-M4平台上的落地问题。内容涵盖UCOS_II任务调度、信号量、消息队列与内存管理机制,并涉及时钟初始…

2026/10/15 17:13:26

PySide6无COM实现Word转PDF:python-docx+pdfkit方案

简介:本资源是一个基于PySide6开发的轻量级Word转PDF桌面工具,面向Python初学者、办公自动化需求者及GUI编程入门者,解决日常文档格式转换中操作繁琐、依赖在线服务或专业软件的问题。压缩包为RAR格式,仅含1个核心Python脚本&…

2026/10/15 17:13:26

嵌入式Linux C编程避坑指南:交叉编译、系统调用与内存管理实战

简介:本资源是面向嵌入式开发初学者的Linux C编程系统入门教程,聚焦ARM平台下的操作系统部署、命令行操作、硬件交互与应用开发全流程,解决从理论到实践脱节的核心痛点。压缩包为RAR格式,大小11.34MB,含完整配套源代码…

2026/10/15 17:13:26

嵌入式Linux C编程实战:从交叉编译到字符设备驱动

简介:本资源是面向嵌入式开发初学者的Linux C编程入门教程,聚焦ARM平台下的系统部署、命令行操作、硬件交互与应用开发全流程,解决从环境搭建到驱动编写的学习断层问题。压缩包为RAR格式,大小11.34MB,含完整配套源代码…

2026/10/15 17:13:26

IMX6ULL嵌入式Linux下Qt交叉编译与linuxfb部署实战

第一次把 Qt 程序跑在 IMX6ULL 开发板的 LCD 屏幕上时,我盯着那个白色窗口愣了好一会儿——不是因为它跑得多流畅,而是这整个过程远比我想象中要绕:先要交叉编译 tslib 做触摸校准,给 Qt 源码配置一大堆构建开关,把几百…

2026/10/14 11:31:03

Python调用Gemini Structured Outputs实现工单路由门禁

客服工单最怕的不是模型“答错一句话”,而是它给出一段看起来合理的说明,程序却从中猜错优先级。通俗做法是:要求模型只交 JSON(JavaScript Object Notation,轻量数据格式),再让代码验证它。Gem…

2026/10/14 17:41:07

Spring Boot超市进销存系统毕设实战:从需求拆解到答辩通关

最近带的一个学生项目组里,有A同学跑来问我:选什么毕设题目最稳妥,既能让评审老师觉得工作量够,又不会在答辩时被问到语无伦次。我第一反应就是推荐基于Spring Boot的超市仓库管理系统——也就是超市进销存系统。这个题目乍一看平…

2026/10/15 13:42:16

Flutter StatefulWidget 生命周期核心解析

很多刚开始接触 Flutter 的朋友,在看完一堆“Hello World”和基础组件之后,大概率都会撞上同一堵墙:StatefulWidget 里那堆 initState、build、dispose 方法,到底什么时候被调用?为什么顺序是那样?在里面到…

2026/10/15 0:02:22

防关联浏览器哪个好?三款产品实测差异解析

新手做多店铺,最纠结的就是防关联浏览器选哪个。飞跨、网易、站斧这三款被问得最多,先给结论:要一体化省心、长期便宜,选站斧;要网易招牌和稳,选网易;预算紧做东南亚 Lazada,选飞跨。…

2026/10/15 0:02:22

影刀RPA深度实战:大模型Fine-tuning定制RPA专用Prompt与指令生成

影刀RPA深度实战:大模型Fine-tuning定制RPA专用Prompt与指令生成 一、技术背景 大模型(LLM)在通用场景下表现强大,但当我们将 GPT-4 或 Qwen 直接用于生成影刀RPA操作指令和 XPath 定位时,准确率通常只有 40%-60%。原因…

还想了解更多?直接咨询顾问

免费诊断 + 免费方案 + 透明报价。

全国咨询热线400-8866-253
免费获取方案
☎咨询二维码 ☎ ↑