NarratoAI README

The project's README from github.com/linyqh/NarratoAI. As one markdown file: README.md.

NarratoAI 😎📽️

一站式 AI 影视解说+自动化剪辑工具🎬🎞️

📖 English | 简体中文 | ☁️ 云端版入口 (NarratoAI.co)


NarratoAI 是一款自动化影视解说工具，基于 LLM 实现文案撰写、自动化视频剪辑、配音和字幕生成的一站式流程，助力高效内容创作。支持本地部署开源版及 云端托管版。


GitHub stars GitHub issues madewithlove


💬 加入开源社群，获取项目动态和最新资讯


🎉🎉🎉 官方文档 🎉🎉🎉

界面预览

重磅福利 🎉

APIMart

感谢 APIMart 赞助了本项目！APIMart 是专注 AI 图片/视频生成的低价 API 平台，GPT-Image-2 低至 $0.006/张，1 美元可出图 160+ 张。图片、视频一套异步 API 通吃，提交任务拿 ID、回调取结果，跑批万张不超时、换模型不改代码。按量付费、无月费，通过此注册链接注册即可开用。

APIMart

即日起全面支持硅基流动！注册即享2000万免费Token（价值16元平台配额），剪辑10分钟视频仅需0.1元！

🔥 快速领福利：
1️⃣ 点击链接注册：https://cloud.siliconflow.cn/i/MI9PgHwB
2️⃣ 使用手机号登录，务必填写邀请码：MI9PgHwB
3️⃣ 领取16元配额，极速体验高性价比AI剪辑

💡 小成本大创作：
硅基流动API Key一键接入，智能剪辑效率翻倍！
（注：邀请码为福利领取唯一凭证，注册后自动到账）

立即行动，用「MI9PgHwB」解锁你的AI生产力！

⚠️谨防被骗 📢

🔎 名称辨析：NarratoAI 与 NarratorAI 项目关系、开源范围与使用方式说明

1. NarratoAI 是一款完全免费的软件，近期在社交媒体(抖音,B站等)上发现，有人将 NarratoAI 改名后售卖，下面是部分截图，请大家务必提高警惕，切勿上当受骗

诈骗截图 1 诈骗截图 2 诈骗截图 3 诈骗截图 4

最新资讯

v0.8.6 更新亮点

功能 说明
IndexTTS-1.5 macOS 新增面向 Apple Silicon 的 MLX 本地语音克隆引擎，可上传或从资源目录选择参考音频。下载部署包
IndexTTS-2 MLX 更新 MLX Pack API 适配，支持参考音频、情感控制、随机种子和更完整的生成参数。macOS 部署包（Windows 版本待更新）
OmniVoice 补充 OmniVoice-Pack 部署包下载入口；该引擎支持自动音色、指令音色和参考音频克隆。macOS 部署包 / Windows 部署包

未来计划 🥳

快速启动 🚀

方式一：整合包（推荐）

下载地址：https://cutagent.online/

请下载与系统对应的整合包并完整解压；不要单独移动其中的 NarratoAI、runtime 或 tools 等目录。Windows 使用 x64 版本；macOS 使用 Apple Silicon（M1/M2/M3/M4）arm64 版本。

Windows

  1. 打开解压后的 NarratoAI-windows-x64 目录。
  2. 先双击 update-windows.bat 更新项目，等待窗口提示更新完成。
  3. 再双击 start.bat 启动应用，并保持启动窗口打开。
  4. 在浏览器访问 http://127.0.0.1:8501。

macOS（Apple Silicon）

  1. 打开解压后的 NarratoAI-macos-arm64 目录。

  2. 若系统阻止打开脚本，请在“终端”中执行（将路径替换为实际解压位置）：

    xattr -cr "/path/to/NarratoAI-macos-arm64"
chmod +x "/path/to/NarratoAI-macos-arm64/"*.command

  3. 先双击 update-macos.command 更新项目，等待更新完成。

  4. 再双击 start-macos.command 启动应用，并保持终端窗口打开。

  5. 在浏览器访问 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

配置要求 📦

反馈建议 📢

👏 1. 可以提交 issue或者 pull request

💬 2. 加入开源社区交流群

📷 3. 关注公众号【NarratoAI助手】，掌握最新资讯

参考项目 📚

该项目基于以上项目重构而来，增加了影视解说功能，感谢大佬的开源精神 🥳🥳🥳

请作者喝一杯咖啡 ☕️

Image 1 Image 2

赞助

Powered by DartNode

许可证 📝

点击查看 LICENSE 文件

Star History

Star History Chart

NarratoAI (linyqh/NarratoAI)

Searching Database…

11.5K ·GitHub
NarratoAI
这是什么？NarratoAI 是一款一体化的 AI 工具，用于影视解说和自动化视频剪辑：它借助大语言模型撰写解说文稿，然后自动剪辑素材、生成配音，并添加字幕。
这是桌面应用，还是通过浏览器访问的服务？它以可下载的 Windows/macOS 集成包形式发布，运行后会启动一个本地服务器，你通过浏览器中的网页界面使用它；如果不想自己运行，还可以使用官网 NarratoAI.co 上托管的云端版本。
我该如何让它运行起来？下载适合你操作系统的集成包（NarratoAI-windows-x64 或 NarratoAI-macos-arm64），完整解压，且不要挪动解压后的内部文件夹；运行更新脚本（update-windows.bat / update-macos.command），再运行启动脚本，然后在浏览器中打开网页界面。另外还提供 macOS 的 Docker 部署方式和普通的本地运行方式。
运行之前需要准备什么？需要 Python 3.12+、Windows 10/11 或 macOS 11.0+，至少 4 核 CPU 和 8GB 内存；不需要 GPU。你还需要为所配置的大语言模型（LLM）和语音合成（TTS）服务商准备 API 密钥，例如 DeepSeek、Gemini、Qwen2-VL。
目前有哪些不足之处需要我注意？IndexTTS-2 MLX 语音克隆组件包的 Windows 版尚未发布（目前只有 macOS 版）；另外，项目最近出于安全考虑，去掉了 LiteLLM 依赖，只保留兼容 OpenAI 接口的请求方式。
为什么 README 要提醒防范诈骗？据报道，有人把这个免费开源项目改了名字，然后在抖音、哔哩哔哩等社交平台上倒卖，因此作者明确提醒用户不要为它付费。
哪些大模型可以生成解说文稿？支持 DeepSeek R1/V3、阿里的 Qwen2-VL（用于视频理解）、Gemini，以及其他兼容 OpenAI 接口的服务商；也可以选择使用 TwelveLabs Pegasus 作为视频理解后端。
支持语音克隆吗？支持。可通过 IndexTTS-1.5、面向 Apple 芯片并经 MLX 加速的 IndexTTS-2 版本，以及 OmniVoice 引擎实现，另外还有腾讯云、豆包等常规语音合成选项。
除了完整解说，它还能做什么？它还可以自动混剪短剧片段、一键转录字幕、合并源素材片段、导出剪映草稿，并自动清理缓存。
What are similar projects?MoneyPrinterTurbo, kirara-ai, Pixelle-Video, pyvideotrans, AstrBot, Easel, WanGP, GPT-SoVITS
Which topics is it in?gemini-api, voice-cloning, video-editing, webui, discord, text-to-speech, qwen, video-generation, apple-silicon, deepseek, gemini, chinese
Creator
linyqh
Size
10.5 MB
Stars
11.5K
Updated
CommitSep 17Releasev0.8.7Jul 17
Age
2y
Commits · 90 Days