NarratoAI 😎📽️

An all-in-one AI-powered tool for film commentary and automated video editing.🎬🎞️

📖 English | 简体中文 | 日本語

[//]: # (

)

NarratoAI is an automated video narration tool that provides an all-in-one solution for script writing, automated video editing, voice-over, and subtitle generation, powered by LLM to enhance efficient content creation.
> **🔥 Highly Recommended: The new paradigm of VibeCut —— [Speclip](https://speclip.com) , a true editing Agent! [👉 Click to download for free](https://speclip.com)** [![madewithlove](https://img.shields.io/badge/made_with-%E2%9D%A4-red?style=for-the-badge&labelColor=orange)](https://github.com/linyqh/NarratoAI) [![GitHub license](https://img.shields.io/github/license/linyqh/NarratoAI?style=for-the-badge)](https://github.com/linyqh/NarratoAI/blob/main/LICENSE) [![GitHub issues](https://img.shields.io/github/issues/linyqh/NarratoAI?style=for-the-badge)](https://github.com/linyqh/NarratoAI/issues) [![GitHub stars](https://img.shields.io/github/stars/linyqh/NarratoAI?style=for-the-badge)](https://github.com/linyqh/NarratoAI/stargazers) 💬 Join the open source community to get project updates and the latest news.

🎉🎉🎉 Official Documentation 🎉🎉🎉

Home

![](docs/index-en.png)

Video Review Interface

![](docs/check-en.png)

## Major Benefits 🎉 ### APIMart Thanks to APIMart for sponsoring this project! APIMart is a low-cost API platform for AI image & video generation — GPT-Image-2 from $0.006/image, 160+ images per dollar. One async API covers both image and video: submit a task, get an ID, fetch results via polling or callback. Batch tens of thousands of images without timeouts, switch models without changing code. Pay-as-you-go with no monthly fee — [sign up here to get started](https://go.apimart.ai/gh-narratoai).

APIMart

From now on, fully support DeepSeek model! Register to enjoy 20 million free tokens (worth 14 yuan platform quota), editing a 10-minute video only costs 0.1 yuan! 🔥 Quick benefits: 1️⃣ Click the link to register: https://cloud.siliconflow.cn/i/pyOKqFCV 2️⃣ Log in with your phone number, **be sure to fill in the invitation code: pyOKqFCV** 3️⃣ Receive a 14 yuan quota, experience high cost-effective AI editing quickly! 💡 Low cost, high creativity: Silicon Flow API Key can be integrated with one click, doubling intelligent editing efficiency! (Note: The invitation code is the only proof for benefit collection, automatically credited after registration) Immediately take action to unlock your AI productivity with "pyOKqFCV"! 😊 Update Steps: Integration Package: Click update.bat one-click update script Code Build: Use git pull to fetch the latest code ## Announcement 📢 _**Note⚠️: Recently, someone has been impersonating the author on x (Twitter) to issue tokens on the pump.fun platform! This is a scam!!! Do not be deceived! Currently, NarratoAI has not made any official promotions on x (Twitter), please be cautious**_ Below is a screenshot of this person's x (Twitter) homepage Screenshot_20250109_114131_Samsung Internet

Screenshot_20250109_114131_Samsung Internet

## Latest News - 2026.07.02 Released version 0.8.4 with Doubao TTS API Key setup and legacy credential compatibility - 2026.04.03 Released version 0.7.8, refactored the documentary frame-analysis pipeline with a shared service and improved extraction, caching, vision batching, and narration generation - 2025.05.11 Released new version 0.6.0, supports **short drama commentary** and optimized editing process - 2025.03.06 Released new version 0.5.2, supports DeepSeek R1 and DeepSeek V3 models for short drama mixing - 2024.12.16 Released new version 0.3.9, supports Alibaba Qwen2-VL model for video understanding; supports short drama mixing - 2024.11.24 Opened Discord community: https://discord.com/invite/V2pbAqqQNb - 2024.11.11 Migrated open source community, welcome to join! [Join the official community](https://github.com/linyqh/NarratoAI/wiki) - 2024.11.10 Released official documentation, details refer to [Official Documentation](https://p9mf6rjv3c.feishu.cn/wiki/SP8swLLZki5WRWkhuFvc2CyInDg) - 2024.11.10 Released new version v0.3.5; optimized video editing process, ## Future Plans 🥳 - [x] Windows Integration Pack Release - [x] Optimized the story generation process and improved the generation effect - [x] Released version 0.3.5 integration package - [x] Support Alibaba Qwen2-VL large model for video understanding - [x] Support TwelveLabs Pegasus as an optional video-understanding backend (analyzes footage natively to drive highlight selection and commentary; opt-in, set `vision_llm_provider = "twelvelabs"`) - [x] Support short drama mixing - [x] One-click merge materials - [x] One-click transcription - [x] One-click clear cache - [x] Support exporting to Jianying drafts - [X] Support short drama commentary - [ ] Character face matching - [ ] Support automatic matching based on voiceover, script, and video materials - [X] Support more TTS engines - [X] Support optional AI-generated background music - [ ] ... ## System Requirements 📦 - Recommended minimum: CPU with 4 cores or more, 8GB RAM or more, GPU is not required - Windows 10/11 or MacOS 11.0 or above - [Python 3.12+](https://www.python.org/downloads/) ## Local Run 🚀 ```bash git clone https://github.com/linyqh/NarratoAI.git cd NarratoAI uv sync cp config.example.toml config.toml uv run streamlit run webui.py --server.maxUploadSize=2048 ``` ## Feedback & Suggestions 📢 👏 1. You can submit [issue](https://github.com/linyqh/NarratoAI/issues) or [pull request](https://github.com/linyqh/NarratoAI/pulls) 💬 2. [Join the open source community exchange group](https://github.com/linyqh/NarratoAI/wiki) 📷 3. Follow the official account [NarratoAI助手] to grasp the latest news ## Reference Projects 📚 - https://github.com/FujiwaraChoki/MoneyPrinter - https://github.com/harry0703/MoneyPrinterTurbo This project was refactored based on the above projects with the addition of video narration features. Thanks to the original authors for their open-source spirit 🥳🥳🥳 ## Buy the Author a Cup of Coffee ☕️

## License 📝 Click to view [`LICENSE`](LICENSE) file ## Star History [![Star History Chart](https://star-history.dera.page/svg?repos=linyqh/NarratoAI&type=Date)](https://star-history.dera.page/#linyqh/NarratoAI&Date)