viral-clips-crew - GitLite

KO | EN

gitlite — search

#javascript #react #ai #android #rust #linux #java #cli #kubernetes #vue #awesome-list #security #openai #open-source

viral-clips-crew

(★ 761)

Your CrewAI Powered Video Editing Assistant

File Explorer

Download Latest Version (.zip)

- - pylint.yml
- .gitignore
- discord.xml
- agents.cpython-312.pyc
- clipper.cpython-310.pyc
- clipper.cpython-311.pyc
- clipper.cpython-312.pyc
- crew.cpython-310.pyc
- crew.cpython-311.pyc
- crew.cpython-312.pyc
- extracts.cpython-310.pyc
- extracts.cpython-311.pyc
- extracts.cpython-312.pyc
- local_transcribe.cpython-310.pyc
- local_transcribe.cpython-312.pyc
- subtitler.cpython-310.pyc
- subtitler.cpython-311.pyc
- subtitler.cpython-312.pyc
- tasks.cpython-312.pyc
- transcribe.cpython-311.pyc
- transcribe.cpython-312.pyc
- trimmer.cpython-311.pyc
- trimmer.cpython-312.pyc
- utils.cpython-310.pyc
- utils.cpython-312.pyc
- ytdl.cpython-310.pyc
- ytdl.cpython-312.pyc
- api_response.json
- vcc-github-banner.png
- vcc-github-cool-gfx.png
- PLACE_CLIPS_HERE
- faster_subs_prompt.txt
- yt_url_variants_list.txt
.gitignore
app.py
clipper.py
crew.py
extracts.py
LICENSE
local_transcribe.py
poetry.lock
pyproject.toml
README.md
reboot.py
subtitler.py
utils.py
ytdl.py

# Installation Guide

1. Get the code

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

Downloads the entire project code from GitHub to your computer.

cd viral-clips-crew

Moves into the project folder you just downloaded.

2. Official Install Script

Easy Recommended

Prerequisites

Python 3 Python is required to use pip.

pip install poetry

Installs the package published on PyPI directly — no need to clone the source.

✅ After installing, open a new terminal and run the program's version command (e.g. --version) to confirm it worked.

Pulled directly from this repo's README.

3. Python

Easy

Prerequisites

Git Needed to download the project code from GitHub.
Python 3 On Windows, be sure to check 'Add Python to PATH' during installation.

pip install poetry

Installs the package published on PyPI directly — no need to clone the source.

poetry install

Installs the libraries listed in pyproject.toml.

poetry update pydantic

Type this command into your terminal and run it.

poetry run python app.py

Runs the Python script (or module).

✅ If it runs without errors and prints output in the terminal, it worked.

Pulled directly from this repo's README.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<a href="https://x.com/alxfazio" target="_blank">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="images/vcc-github-banner.png">
    <img alt="OpenAI Cookbook Logo" src="images/vcc-github-banner.png" width="400px" style="max-width: 100%; margin-bottom: 20px;">
  </picture>
</a>

Your [CrewAI](https://github.com/joaomdmoura/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

<div align="center">
  <img src="https://github.com/alexfazio/viral-clips-crew/assets/34505954/c69da629-06eb-4279-a5cb-0d8d7fc1dfee" width="600px" height="auto">
</div>

`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

1. Clone this repository to your local machine:

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

2. Install Poetry to automatically manage project dependencies:

```shell
    pip install poetry
    ```

3. Install the required Python packages using Poetry:

```shell
    poetry install
    ```

4. Update Pydantic:

```shell
    poetry update pydantic
    ```

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

```shell
   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](https://x.com/Cyb3rCh1ck3n) for his ongoing assistance in improving this tool.

## License

[MIT](https://opensource.org/licenses/MIT)

Copyright (c) 2024-present, Alex Fazio

---

[![Watch the video](https://i.imgur.com/TBD2bvj.png)](https://x.com/alxfazio/status/1791863931931078719)