https://github.com/rhythrosalabs/multi-agent-viral-video-maker
create longform HD videos with music and voice.
https://github.com/rhythrosalabs/multi-agent-viral-video-maker
Last synced: about 1 year ago
JSON representation
create longform HD videos with music and voice.
- Host: GitHub
- URL: https://github.com/rhythrosalabs/multi-agent-viral-video-maker
- Owner: RhythrosaLabs
- Created: 2025-05-29T19:22:06.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2025-06-05T21:46:51.000Z (about 1 year ago)
- Last Synced: 2025-06-05T22:28:31.718Z (about 1 year ago)
- Language: Python
- Size: 83 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# đŦ AI Multi-Agent Video Creator
Explore the UI:
https://viral-video-maker.streamlit.app
A powerful and flexible web app built with **Streamlit**, **Replicate**, and **MoviePy** that enables you to generate short educational or cinematic videos automatically. Simply enter a topic, configure settings, and let AI agents handle everything from scriptwriting to video generation and narration.
---
## đ Features
- âī¸ **Script Generation** using Claude-4 Sonnet
- đ¤ **Voiceover Narration** using Minimax Speech O2
- đĨ **Visual Scene Creation** using Luma Ray 2
- đš **Background Music** using Google Lyria
- đ **Optional Voiceover and Audio Mixing**
- đŧī¸ **Customizable Video Styles** (Documentary, Cinematic, Nature, etc.)
- đ **Aspect Ratios:** 16:9, 9:16, 1:1, 4:3
- đī¸ **Video Lengths:** 10s, 15s, or 20s
- đšī¸ **Camera Motions:** Randomized movements like zooms, pans, orbit, etc.
- đ **Downloadable Scripts** and assets
- đ§ **Multi-Agent Pipeline:** Modular architecture for flexibility and future extensions
---
## đ ī¸ Installation
1. **Clone the repository**
```bash
git clone https://github.com/yourusername/ai-multi-agent-video-creator.git
cd ai-multi-agent-video-creator
```
2. **Install dependencies**
It is typically best practice to use a virtual environment:
```bash
python -m venv venv
source venv/bin/activate # on Windows: venv\Scripts\activate
pip install -r requirements.txt
```
3. **Set up your Replicate API key**
You can get your API key from [replicate.com/account](https://replicate.com/account).
---
## đ Usage
Run the app with:
```bash
streamlit run app.py
```
Then:
1. Enter your **Replicate API key**.
2. Input a **video topic** (e.g., `"Why the Earth rotates"`).
3. Customize:
- Voice
- Emotion
- Video style, aspect ratio, quality
- Duration and looping
- Camera motion
4. Click **"Generate Video"**.
The app will:
- Write a script using Claude-4 Sonnet
- Generate scenes for each script segment
- Add voiceover narration (optional)
- Compose and add music
- Concatenate video and audio into one final video
- Let you download the full video and all individual elements (such as script, voiceover, music, etc.)
---
## đ File Structure
```plaintext
app.py # Main Streamlit app
requirements.txt # Python dependencies
README.md # You're here!