📖 English | 简体中文 | ☁️ 云端版入口 (NarratoAI.cn)
NarratoAI 是一款自动化影视解说工具，基于 LLM 实现文案撰写、自动化视频剪辑、配音和字幕生成的一站式流程，助力高效内容创作。支持本地部署开源版及 云端托管版。
- 2026.07.02 发布新版本 0.8.4，升级豆包语音 TTS 新版 API Key 配置并保留旧版凭据兼容
- 2026.06.10 发布新版本 0.8.1，大版本更新，优化多个核心流程
- 2026.04.27 发布新版本 0.7.9，新增 Fun-ASR一键转录字幕
- 2026.04.03 发布新版本 0.7.8，重构纪录片逐帧分析链路，统一共享服务并优化抽帧、缓存、视觉并发与文案生成流程
- 2026.03.27 发布新版本 0.7.7，出于安全考虑，已移除 LiteLLM 依赖，统一使用 OpenAI 兼容请求链路
- 2025.11.20 发布新版本 0.7.5，新增 IndexTTS-1.5 语音克隆支持
- 2025.10.15 发布新版本 0.7.3，升级大模型供应商管理能力
- 2025.09.10 发布新版本 0.7.2，新增腾讯云tts
- 2025.08.18 发布新版本 0.7.1，支持 语音克隆 和 最新大模型
- 2025.05.11 发布新版本 0.6.0，支持 短剧解说 和 优化剪辑流程
- 2025.03.06 发布新版本 0.5.2，支持 DeepSeek R1 和 DeepSeek V3 模型进行短剧混剪
- 2024.12.16 发布新版本 0.3.9，支持阿里 Qwen2-VL 模型理解视频；支持短剧混剪
- 2024.11.24 开通 discord 社群：https://discord.com/invite/V2pbAqqQNb
- 2024.11.11 迁移开源社群，欢迎加入！ 加入官方社群
- 2024.11.10 发布官方文档，详情参见 官方文档
- 2024.11.10 发布新版本 v0.3.5；优化视频剪辑流程，
即日起全面支持硅基流动！注册即享2000万免费Token（价值16元平台配额），剪辑10分钟视频仅需0.1元！
🔥 快速领福利：
1️⃣ 点击链接注册：https://cloud.siliconflow.cn/i/MI9PgHwB
2️⃣ 使用手机号登录，务必填写邀请码：MI9PgHwB
3️⃣ 领取16元配额，极速体验高性价比AI剪辑💡 小成本大创作：
硅基流动API Key一键接入，智能剪辑效率翻倍！
（注：邀请码为福利领取唯一凭证，注册后自动到账）立即行动，用「MI9PgHwB」解锁你的AI生产力！
1. NarratoAI 是一款完全免费的软件，近期在社交媒体(抖音,B站等)上发现，有人将 NarratoAI 改名后售卖，下面是部分截图，请大家务必提高警惕，切勿上当受骗
- windows 整合包发布
- 优化剧情生成流程，提升生成效果
- 发布 0.3.5 整合包
- 支持阿里 Qwen2-VL 大模型理解视频
- 支持 TwelveLabs Pegasus 作为可选的视频理解后端（原生理解整段画面以挑选高光、生成解说；可选启用，设置
vision_llm_provider = "twelvelabs"） - 支持短剧混剪
- 一键合并素材
- 一键转录
- 一键清理缓存
- 支持导出剪映草稿
- 支持短剧解说
- 主角人脸匹配
- 支持根据口播，文案，视频素材自动匹配
- 支持更多 TTS 引擎
- ...
请下载与系统对应的整合包并完整解压；不要单独移动其中的 NarratoAI、runtime 或 tools 等目录。Windows 使用 x64 版本；macOS 使用 Apple Silicon（M1/M2/M3/M4）arm64 版本。
- 打开解压后的
NarratoAI-windows-x64目录。 - 先双击
update-windows.bat更新项目，等待窗口提示更新完成。 - 再双击
start.bat启动应用，并保持启动窗口打开。 - 在浏览器访问
http://127.0.0.1:8501。
-
打开解压后的
NarratoAI-macos-arm64目录。 -
若系统阻止打开脚本，请在“终端”中执行（将路径替换为实际解压位置）：
xattr -cr "/path/to/NarratoAI-macos-arm64" chmod +x "/path/to/NarratoAI-macos-arm64/"*.command
-
先双击
update-macos.command更新项目，等待更新完成。 -
再双击
start-macos.command启动应用，并保持终端窗口打开。 -
在浏览器访问
http://127.0.0.1:8501。
# 1. 克隆项目
git clone https://github.com/linyqh/NarratoAI.git
cd NarratoAI
# 2. 一键部署
docker compose up -d
# 3. 访问应用
# 浏览器打开 http://localhost:8501# 1. 克隆项目
git clone https://github.com/linyqh/NarratoAI.git
cd NarratoAI
# 2. 使用 uv 安装依赖
uv sync
# 3. 复制配置文件
cp config.example.toml config.toml
# 4. 编辑 config.toml，配置你的 API 密钥
# 5. 启动应用
uv run streamlit run webui.py --server.maxUploadSize=2048
# 6. 访问应用
# 浏览器打开 http://localhost:8501- 建议最低 CPU 4核或以上，内存 8G 或以上，显卡非必须
- Windows 10/11 或 MacOS 11.0 以上系统
- Python 3.12+
👏 1. 可以提交 issue或者 pull request
💬 2. 加入开源社区交流群
📷 3. 关注公众号【NarratoAI助手】，掌握最新资讯
该项目基于以上项目重构而来，增加了影视解说功能，感谢大佬的开源精神 🥳🥳🥳
点击查看 LICENSE 文件