Spaces:
Sleeping
Sleeping
| title: AI Video Generator | |
| emoji: 🎬 | |
| colorFrom: blue | |
| colorTo: purple | |
| sdk: gradio | |
| sdk_version: 4.0.0 | |
| app_file: app.py | |
| pinned: false | |
| # 🎬 AI Video Generator | |
| An AI-powered video generator that creates engaging videos with text-to-speech voiceovers, animated subtitles, and professional transitions. | |
| ## ✨ Features | |
| - **Text-to-Speech**: Convert text to natural-sounding speech using Google's Gemini TTS | |
| - **Multiple Voices**: Choose from 5 different AI voices | |
| - **Audio Upload**: Upload your own voiceover audio | |
| - **Automatic Subtitles**: Word-by-word highlighted subtitles generated automatically | |
| - **Video Transitions**: Multiple transition effects (Smooth Blend, Ken Burns Zoom, Whip Pan, etc.) | |
| - **Background Music**: Add background music to your videos | |
| - **Custom Titles**: Add animated title overlays | |
| ## 🚀 Setup Instructions | |
| ### 1. Initial Setup on Hugging Face | |
| 1. Go to [Hugging Face Spaces](https://huggingface.co/spaces) | |
| 2. Click "Create new Space" | |
| 3. Choose a name (e.g., "my-video-generator") | |
| 4. Select **Gradio** as the SDK | |
| 5. Choose hardware (CPU is free, GPU recommended) | |
| 6. Click "Create Space" | |
| ### 2. Add Your Google API Key | |
| 1. Go to Space Settings → Repository secrets | |
| 2. Click "New secret" | |
| 3. Name: `GOOGLE_API_KEY` | |
| 4. Value: Your Google API key (get one from [Google AI Studio](https://aistudio.google.com/app/apikey)) | |
| 5. Click "Add" | |
| ### 3. Upload Required Files | |
| Upload these files to your Space: | |
| - `app.py` (main application) | |
| - `requirements.txt` (Python dependencies) | |
| - `packages.txt` (system dependencies) | |
| - `README.md` (this file) | |
| ### 4. Add Video Clips | |
| **IMPORTANT**: You need to add video clips for the generator to work! | |
| 1. In your Space, click "Files and versions" | |
| 2. Click "Add file" → "Create a new file" | |
| 3. Create a folder called `video_clips` | |
| 4. Upload at least 5-10 video clips (`.mp4`, `.avi`, `.mkv`, or `.mov`) | |
| **Tips for video clips:** | |
| - Use clips that are 5-30 seconds long | |
| - HD quality (1080p or 720p) works best | |
| - Nature, city, abstract, or stock footage works great | |
| - More clips = more variety in your videos | |
| ### 5. Optional: Add Background Music | |
| 1. Create a folder called `background_music` | |
| 2. Upload `.mp3` or `.wav` files | |
| 3. Music will be automatically added at low volume | |
| ## 📖 How to Use | |
| 1. **Enter Text**: Type or paste the text you want converted to speech | |
| 2. **Choose Voice**: Select from 5 AI voices | |
| 3. **OR Upload Audio**: Upload your own voiceover (instead of TTS) | |
| 4. **Add Title** (optional): Enter a title to display at the start | |
| 5. **Set Duration**: Only used if no audio is provided | |
| 6. **Choose Quality**: High (1080p), Standard (720p), or Preview (480p) | |
| 7. **Select Transition**: Choose your preferred transition effect | |
| 8. **Click Generate**: Wait for your video to be created! | |
| ## 🎥 Output | |
| The generated video will include: | |
| - Your selected video clips with transitions | |
| - Voiceover audio (TTS or uploaded) | |
| - Animated word-by-word subtitles | |
| - Optional title overlay | |
| - Optional background music | |
| ## 🔧 Troubleshooting | |
| **"Video clips folder not found"** | |
| - Make sure you've uploaded videos to the `video_clips` folder | |
| **"TTS failed"** | |
| - Check that your Google API key is correctly set in Space settings | |
| - Verify the API key has the Gemini API enabled | |
| **Slow generation** | |
| - Consider upgrading to GPU hardware in Space settings | |
| - Reduce video quality to "Preview" for faster processing | |
| **Out of memory** | |
| - Use fewer/shorter video clips | |
| - Reduce video quality setting | |
| - Upgrade to larger hardware | |
| ## 📝 File Structure | |
| ``` | |
| your-space/ | |
| ├── app.py # Main application | |
| ├── requirements.txt # Python dependencies | |
| ├── packages.txt # System dependencies | |
| ├── README.md # This file | |
| ├── video_clips/ # Your video files (REQUIRED) | |
| │ ├── clip1.mp4 | |
| │ ├── clip2.mp4 | |
| │ └── ... | |
| ├── background_music/ # Optional music files | |
| │ └── music.mp3 | |
| ├── voice_over/ # Generated voiceovers (auto-created) | |
| └── exports/ # Generated videos (auto-created) | |
| ``` | |
| ## 🎨 Customization | |
| You can customize the app by editing `app.py`: | |
| - Change subtitle styling | |
| - Modify transition effects | |
| - Adjust video processing settings | |
| - Add new features | |
| ## 📄 License | |
| This project uses various open-source libraries. Please ensure compliance with their licenses. | |
| ## 🙋 Support | |
| If you encounter issues: | |
| 1. Check the Space logs for error messages | |
| 2. Verify all setup steps are completed | |
| 3. Ensure video clips are uploaded | |
| 4. Check that API key is correctly set | |
| ## 🌟 Credits | |
| Built with: | |
| - Gradio | |
| - MoviePy | |
| - OpenAI Whisper | |
| - Google Generative AI | |
| - Pillow | |
| --- | |
| Made with ❤️ using Hugging Face Spaces |