viral-clips-crew

alexfazioMIT更新放缓

基于 CrewAI 多智能体协作的视频剪辑助手，自动完成视频下载、语音转写和片段剪辑，适合批量产出短视频素材。

Your CrewAI Powered Video Editing Assistant

暂无版本770star116fork同步于 2026-11-07 07:30 UTC

视频剪辑多智能体语音转写短视频自动化

对比 GitHub 官网 crewai ffmpeg whisper yt-dlp

怎么上手

由 README 提炼，执行前请确认

原文

git clone https://github.com/alexfazio/viral-clips-crew.git
pip install poetry
poetry install
poetry update pydantic
echo -e "OPENAI_API_KEY=<your-api-key>\nGEMINI_API_KEY=<your-api-key>" > .env
poetry run python app.py

硬件要求按 README 说明

README 未说明本地显存或 GPU 要求；视频处理依赖 OpenAI 与 Google Gemini 云端 API，Gemini 可处理 1 小时以内视频，OpenAI 需控制在 15 分钟以内。

下载：源码 zip·GitHub Releases（安装包）本站不镜像安装包

项目说明

由 README 自动翻译提炼

没人工点评？写下你的经验

用 CrewAI 驱动的视频剪辑助手，自动从长视频里挑出可能爆的片段

基于 CrewAI 多智能体协作的视频剪辑助手，自动完成视频下载、语音转写和片段剪辑，适合批量产出短视频素材。

核心能力

用 CrewAI 多智能体流程自动分析长视频内容
从长视频中提取最具传播潜力的高光片段
自动为片段生成字幕并输出到 subtitler_output 目录
支持复用他人内容做二次创作与分发

容易踩的坑

需同时配置 OpenAI 和 Google Gemini 两个 API key，缺一个会报 TypeError: 'NoneType' object is not iterable；用 OpenAI 时视频须短于 15 分钟，否则超出上下文窗口；项目作者声明不提供支持、仅供演示，不适合生产使用。

内容由模型根据 README 生成，可能不完整或不准确，以官方文档为准。看原文 README

用户点评

登录用户的真实使用记录，可按版本和硬件筛选

共 0 条

还没有人点评。第一个说出真实体验的人最有价值。

README 原文

未翻译

在 GitHub 打开

Your CrewAI Powered Video Editing Assistant

Are you a social media content curator? Skip the tedious editing process and get polished video highlights in minutes. viral-clips-crew watches and listens to long-form content, extracting the most striking and potentially viral segments, ready for publication on social media.

[!note] This project was 99% vibe coded as a fun Saturday hack. I'm not going to support it in any way, it's provided here as is for other people's inspiration and I don't intend to improve it. Code is ephemeral now and libraries are over, ask your LLM to change it in whatever way you like.

Content Repurposing Made Easy

viral-clips-crew helps you repackage your valuable content in new and engaging ways to capture attention on social media and drive traffic back to the original long-form piece. Whether you're looking to refresh your own content or recycle content from other creators, this tool streamlines the process, making content repurposing effortless and efficient.

Requirements

This project requires:

Python 3.7+
CrewAI
OpenAI API key and Google Gemini API key

All required Python libraries are listed in pyproject.toml.

Installation

Clone this repository to your local machine:

git clone https://github.com/alexfazio/viral-clips-crew.git

Install Poetry to automatically manage project dependencies:
```
pip install poetry
```
Install the required Python packages using Poetry:
```
poetry install
```
Update Pydantic:
```
poetry update pydantic
```

Open .env and insert your OpenAI API key and Google Gemini API key.

echo -e "OPENAI_API_KEY=<your-api-key>\nGEMINI_API_KEY=<your-api-key>" > .env

Usage

After setting up, drag your desired clip into the input_files directory.

Gemini can process videos up to 1 hour in length. If you are using the OpenAI API, please ensure that the clip is less than 15 minutes in length. The current LLM context windows are approximately 15 minutes.

Run viral-clips-crew using Poetry with the following command:

```shell
poetry run python app.py
```

This will kickstart the process from beginning to completion.

Final output will be in the subtitler_output directory.

Support

If you like this project and want to support it, please consider leaving a star. Every contribution helps keep the project running. Thank you!

Troubleshooting

If you encounter a TypeError: 'NoneType' object is not iterable, please check the following:

Ensure your API keys are correctly set in the .env file.
Verify that you have enough pay-as-you-go credits in your OpenAI account and Google Cloud account.

Note

The code for viral-clips-crew is intended for demonstrative purposes and is not meant for production use. The API keys are hardcoded and need to be replaced with your own. Always ensure your keys are kept secure.

Credits

Thank you to Rip&Tear for his ongoing assistance in improving this tool.

License

MIT