makereels / README.md
yonagush's picture
Update README.md
69bd7b9 verified
---
title: AI Reels Maker
emoji: 🎬
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: 6.10.0
app_file: app.py
pinned: false
license: mit
---
# 🎬 AI Reels Maker
Turn any URL or topic into a **viral vertical video reel** β€” free, no watermark, no sign-up required.
## ✨ Features
### 🎬 Reel Generator
- Paste any **news article / blog post URL** or type a topic
- **10+ reel types**: Top 5 Β· Fact Β· Ranking Β· Step-by-Step Guide Β· Statistics Β· Quiz Β· Famous Quotes Β· Product Demo Β· Joke Β· Blog to Reel Β· Custom Prompt
- AI script powered by **Llama 3.3-70B** via Groq (free)
- **Two voice engines**: Edge TTS (Microsoft, 10 voices) OR Kokoro TTS (open-source, 8 voices)
- **Background video** auto-fetched from Pexels based on topic
- **Logo overlay** β€” upload your PNG/JPG logo, choose position
- **Custom accent color** for brand consistency
- No watermark Β· Download as MP4
### πŸ“Ί News Anchor Mode
- Upload **your own anchor / presenter video**
- Replace background: Blur Β· News Studio (dark/light) Β· Pexels video Β· Solid color
- Add **professional lower-third** (name + title bar)
- Add **scrolling gold news ticker** at bottom
- Overlay **channel logo**
- Custom accent / brand color
---
## πŸ”‘ Free API Keys You Need
| Service | Purpose | Get it free |
|---------|---------|-------------|
| **Groq** *(required)* | AI script generation (Llama 3.3-70B) | [console.groq.com](https://console.groq.com) |
| **Pexels** *(optional)* | Free HD stock video backgrounds | [pexels.com/api](https://www.pexels.com/api/) |
Both are completely free β€” no credit card needed.
---
## πŸš€ How to Use
1. Go to the **Reel Generator** tab
2. Paste a URL (e.g. a BBC article) or type a topic like *"Top 5 AI tools 2025"*
3. Choose a **Reel Type** (Top 5, Fact, Quiz, etc.)
4. Enter your **Groq API key**
5. Optionally enter your **Pexels API key** for background video
6. Pick a **voice** and click **Generate Reel** πŸš€
7. Download your MP4!
For **News Anchor Mode**:
1. Go to the **News Anchor Mode** tab
2. Upload your anchor/presenter video
3. Choose a background style
4. Add your name, title, ticker text, and logo
5. Click **Process Anchor Video** πŸ“Ί
---
## πŸ› οΈ Tech Stack
- **Gradio** β€” UI
- **Groq + Llama 3.3-70B** β€” script generation
- **Edge TTS** β€” Microsoft neural TTS (free, no key needed)
- **Kokoro TTS** β€” open-source neural TTS
- **MoviePy + Pillow** β€” video assembly and text rendering
- **Pexels API** β€” free stock videos
- **Trafilatura** β€” URL content extraction