NarratoAI

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

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署开源模型 🍴 复刻 1614 🐛 待处理 10 👀 关注 64

访问官网 ↗ GitHub ↗

GitHub 星标 ★ 11756

维护状态较活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT许可证，完全免费，可自行部署使用。

项目预览

项目数据

分类开源模型

开发团队linyqh

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

GitHubhttps://github.com/linyqh/NarratoAI

定价模式🏷️完全免费

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

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言Python

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

GitHub 星标★ 11756

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

代码更新2026-10-24

仓库体积10.6 MB

本站数据更新2026-11-09

维护状态较活跃

收录时间2026-08-09

浏览次数7

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 11756

技术标签

aiagent aiops gemini-api llm python

使用教程

ℹ 本教程由 AI 依据该项目 README 整理，个别步骤可能需要按你的环境微调。

难度：入门约 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
```