NarratoAI

上传视频，AI 自动写稿配音剪辑，一键出片

NarratoAI 是一个基于 AI 大模型的一站式视频解说与剪辑工具，主要解决视频创作者在制作解说类内容时面临的脚本撰写、配音、字幕和剪辑流程繁琐、耗时的问题。它利用大语言模型自动分析视频内容，生成结构化的解说脚本，并支持将脚本转换为自然语音，同时自动识别视频中的关键画面，完成字幕匹配和粗剪，最终输出带解说和字幕的视频。核心能力包括：视频内容理解与脚本生成、多音色语音合成、字幕自动生成与对齐、基于脚本的智能剪辑。项目采用 Python 编写，提供 Web 界面和 API，支持本地部署，适合个人创作者和小型团队快速生产解说视频。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 11174

维护状态活跃

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队linyqh

所属国家

官网地址https://www.narratoai.cn

GitHubhttps://github.com/linyqh/NarratoAI

定价模式free

价格说明开源项目，MIT许可证，完全免费，可自行部署使用。

访问状态

是否开源是

开源协议MIT

主要语言Python

技术栈/模型aiagent,aiops,gemini-api,llm,moviepy,python

GitHub 星标★ 11174

30天Star增速

HF 下载量

上线时间2024-08-12 00:00:00

最近更新2026-09-22 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数6

使用教程

难度：入门约 15 分钟部署方式：本地安装 6 步

环境要求

Python 3.12+
Windows 10/11 或 macOS 11.0 以上系统
建议 CPU 4 核或以上
建议内存 8G 或以上
显卡非必须

安装与启动步骤

1获取项目源码

把 NarratoAI 仓库克隆到本地并进入项目目录，后续命令都在该目录内执行。
```
git clone https://github.com/linyqh/NarratoAI.git
cd NarratoAI
```
2安装依赖

本地运行方式使用 uv 同步安装项目依赖，请先确保已安装 Python 3.12+ 与 uv。
```
uv sync
```
3复制配置文件

从示例配置复制出 config.toml，这是后面填写 API 密钥用的配置文件。
```
cp config.example.toml config.toml
```
4填写 API 密钥

用文本编辑器打开 config.toml，按注释填入你自己的大模型等 API 密钥并保存。
5启动 Web 应用

用 Streamlit 启动 Web 界面，最大上传 2048MB，终端会打印本地访问地址。
```
uv run streamlit run webui.py --server.maxUploadSize=2048
```
6Docker 方式部署

macOS 用户推荐改为 Docker Compose 一键部署，在项目目录下执行，无需手动装依赖。
```
docker compose up -d
```

关键配置

配置项	必填	说明	示例
`config.toml`	是	项目主配置文件，需编辑并填入自己的 API 密钥	`config.toml`

如何确认成功

终端无报错并打印本地访问地址，浏览器打开该地址能看到 NarratoAI Web 界面即成功。

常见问题

Q：必须要有独立显卡吗？

A：不需要。官方配置要求明确写显卡非必须，建议 CPU 4 核以上、内存 8G 以上即可运行。

Q：支持哪些操作系统？

A：Windows 10/11 或 macOS 11.0 以上系统；macOS 用户推荐使用 Docker Compose 方式部署。

Q：这个软件收费吗？

A：NarratoAI 是一款完全免费的软件，请勿相信社交媒体上改名后售卖的版本。

Q：不想本地部署怎么办？

A：可以使用官方云端托管版，入口为 https://www.narratoai.co。

注意事项

项目完全免费，谨防被他人改名售卖，注意区分 NarratoAI 与 NarratorAI。
macOS 推荐 Docker Compose 部署；本地运行需 Python 3.12+，并提前准备 API 密钥。
详细安装与使用说明请以官方文档（飞书文档）和 GitHub Wiki 为准。

核心亮点

自动生成贴合画面的解说脚本，省去手动写稿
集成配音和字幕，剪辑流程全自动化
支持本地部署，数据隐私可控

不足之处

视频解析和生成速度依赖本地算力，长视频耗时
脚本质量受大模型能力限制，复杂内容需人工修改
文档/社区待观察

适用场景

自媒体博主快速制作影视解说视频
教育机构将课程视频转化为带讲解的教程
企业将产品演示视频自动生成宣传解说

替代项目

Descript、Whisper + GPT 自定义流程、剪映（智能脚本/配音）

项目介绍

NarratoAI 是视频领域的开源项目，由 linyqh 开发，2024 年首次发布。

在全站 13,090 个收录项目中，它的 GitHub 星标数（11,174）位列前 5%，在视频分类的 473 个项目里位列前 4%。

近 41 天，它的 GitHub 星标从 10,683 增加到 11,174，净增 491。

项目目前处于活跃维护状态，最近一次代码更新于 2026-09-22。MIT许可证，完全免费，可自行部署使用。

它主要面向的使用场景是：自媒体博主快速制作影视解说视频。同类可对比的替代方案包括 Descript、Whisper + GPT 自定义流程、剪映（智能脚本/配音）。

上一篇：sd-wav2lip-uhq

下一篇：FunClip