README.md

metadata

title: YouTube Automation Studio
emoji: 🎬
colorFrom: red
colorTo: blue
sdk: docker
pinned: false
license: mit
app_port: 7860

🎬 YouTube Automation Studio

AI-powered automation tool for downloading Instagram Reels, generating metadata with Google Gemini AI, and uploading to YouTube automatically.

✨ Features

• 📥 Instagram Reel Downloader: Download Reels in HD quality with original audio
• 🤖 AI Metadata Generator: Generate SEO-optimized titles, descriptions, tags using Google Gemini 2.0
• 📤 YouTube Auto Uploader: Upload directly to YouTube with automated metadata
• 🎵 Video Editor: Add background music and text overlays to videos
• 🔐 Multi-User Support: Each user has their own isolated YouTube authentication

🚀 Quick Start

1. Set Environment Variables (Required):

   • GEMINI_API_KEY: Get from Google AI Studio
   • IG_SESSIONID: Instagram session cookie (see below)
   • SECRET_KEY: Generate with python -c "import secrets; print(secrets.token_hex(32))"

2. Upload client_secret.json:

   • Create OAuth credentials in Google Cloud Console
   • Enable YouTube Data API v3
   • Download and upload client_secret.json as a secret file

3. Access the app and start automating!

🔑 Getting Instagram Session ID

1. Open Instagram in Chrome
2. Press F12 → Application → Cookies → instagram.com
3. Find sessionid cookie and copy its value
4. Add to Space secrets as IG_SESSIONID

🎯 Usage

1. Sign in with YouTube (OAuth 2.0 - secure & one-time)
2. Paste Instagram Reel URL
3. (Optional) Add video editing:
   • Background music from YouTube or local file
   • Text overlays with custom positioning
4. AI generates metadata (title, description, tags, hashtags)
5. Video uploads to YouTube automatically

🛠️ Tech Stack

• Backend: Flask, Python 3.11, Gunicorn
• AI: Google Gemini 2.0 Flash
• APIs: YouTube Data API v3, Instagram
• Video Processing: MoviePy, OpenCV, FFmpeg
• Auth: OAuth 2.0, Session-based authentication

📋 Environment Variables

Set these in your Hugging Face Space settings:

ENVIRONMENT=production
GEMINI_API_KEY=your-gemini-api-key-here
IG_SESSIONID=your-instagram-sessionid-here
SECRET_KEY=your-secret-key-here

🔒 Security

• OAuth 2.0 for YouTube authentication
• Session-based user isolation
• Secure cookie handling
• No password storage
• Automatic credential refresh

📝 OAuth Redirect URI

Add this to your Google Cloud OAuth credentials: