NarratoAI is a Python-based open-source tool for AI-assisted video narration and automated editing, with local deployment options and a web UI. It supports custom narration length, local TTS options, and multi-platform deployment, with recent version updates and active releases.
Collecting history — the radar snapshots this repo daily. The trend line appears after 3 days of data (1 so far).
What it is
NarratoAI 是一款基于 LLM 的一站式 AI 影视解说和自动化剪辑工具，提供文案撰写、自动化视频剪辑、配音和字幕生成的一体化流程，支持本地部署开源版及云端托管等方案。
How it works
The repository combines AI-driven narration with video editing features and TTS support to generate and synchronize narration with video content. Recent releases mention customizable narration word count, local TTS options (voxcpm-0.5b and voxcpm-2b), and a web UI with LLM integration.
Getting started
方式一：整合包（推荐）
请下载与系统对应的整合包并完整解压；不要单独移动其中的 NarratoAI、runtime 或 tools 等目录。Windows 使用 x64 版本；macOS 使用 Apple Silicon（M1/M2/M3/M4）arm64 版本。
Windows
- 打开解压后的
NarratoAI-windows-x64目录。 - 先双击
update-windows.bat更新项目，等待窗口提示更新完成。 - 再双击
start.bat启动应用，并保持启动窗口打开。 - 在浏览器访问
http://127.0.0.1:8501。
macOS（Apple Silicon）
-
打开解压后的
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。
方式二：macos Docker 部署（macos 推荐）
# 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
Getting started (配置要求)
- 建议最低 CPU 4核或以上，内存 8G 或以上，显卡非必须
- Windows 10/11 或 MacOS 11.0 以上系统
- Python 3.12+
Recent releases
- v0.8.7 (2026-07-17): 添加可自定义的解说文案字数配置；新增 voxcpm-0.5b 和 voxcpm-2b 本地语音合成支持；文档更新；README 更新。
- v0.8.6 (2026-07-16): 新增 Sonilo AI 配乐模式、IndexTTS-1.5、IndexTTS-2 MLX 适配、OmniVoice 部署包入口。
- v0.8.5 (2026-07-12): 优化本地运行、缓存清理及跨平台兼容性等。
- v0.8.4 (2026-07-02): 升级豆包语音 TTS API Key 配置并保留旧版凭据兼容。
- v0.8.3 (2026-06-14): 添加 LL m 驱动字幕翻译、短剧剪辑等功能。
Traction
- stars_7d: 10568 (present in FACTS)
- forks: 1450
License
- MIT
Behind the repo
- 该项目基于以上项目重构而来，增加了影视解说功能。
Caveats
- 许可证: MIT
- open_issues: 5
- created: 2024-08-12
- last_push: 2026-07-23
- 语言: Python