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)

gemini-api
Searching Database…

11.4K ·GitHub
What is this?NarratoAI is an all-in-one AI tool for film/show narration and automated video editing: it uses an LLM to write the narration script, then automatically edits the footage, generates voice-over, and adds subtitles.
Is this a desktop app or something I access through a browser?It ships as a downloadable Windows/macOS integration package that launches a local server, and you use it through a web UI in your browser; there's also a separately hosted cloud version at NarratoAI.co if you don't want to run it yourself.
How do I get it running?Download the integration package for your OS (NarratoAI-windows-x64 or NarratoAI-macos-arm64), unzip it fully without moving the internal folders, run the update script (update-windows.bat / update-macos.command), then the start script, and open the web UI in your browser. A macOS Docker deployment and a plain local-run option are also available.
What do I need before running it?You need Python 3.12+, Windows 10/11 or macOS 11.0+, at least a 4-core CPU and 8GB RAM; a GPU is not required. You'll also need API keys for whichever LLM/TTS providers you configure (e.g. DeepSeek, Gemini, Qwen2-VL).
Any current gaps I should know about?The Windows build of the IndexTTS-2 MLX voice-cloning pack isn't released yet (only the macOS version is), and the project recently dropped its LiteLLM dependency in favor of OpenAI-compatible requests only, for security reasons.
Why does the README warn about scams?People have reportedly renamed this free, open-source project and resold it on social platforms like Douyin and Bilibili, so the authors explicitly warn users not to pay for it.
Which LLMs can generate the narration script?It supports DeepSeek R1/V3, Alibaba's Qwen2-VL for video understanding, Gemini, and other OpenAI-compatible providers; TwelveLabs Pegasus can optionally be used as the video-understanding backend.
Does it support voice cloning?Yes, through IndexTTS-1.5, an MLX-accelerated IndexTTS-2 build for Apple Silicon, and the OmniVoice engine, alongside regular TTS options like Tencent Cloud and Doubao.
What else can it do besides full-length narration?It can also auto-mix short-drama clips, one-click transcribe subtitles, merge source clips, export Jianying (CapCut) drafts, and auto-clean its cache.
Creator
linyqh
Size
10.5 MB
Stars
11.4K
Age
2y
Commits · 90 Days