Spaces:
Running
on
Zero
Running
on
Zero
malvin noel
commited on
Commit
Β·
ce31e17
1
Parent(s):
df925fa
Update Readme 2
Browse files
README.md
CHANGED
@@ -1,112 +1,15 @@
|
|
1 |
-
# π₯ Light AI Video Generator
|
2 |
-
|
3 |
-
**Light AI Video Generator** is an all-in-one Hugging Face Space that lets you create short, compelling AI-powered videos using **just a few inputs**. It handles everything β from script writing and voice generation to background video montage and subtitles.
|
4 |
-
|
5 |
-
> β
No editing skills required.
|
6 |
-
> π₯ Perfect for YouTube Shorts, TikTok, Reels, and more.
|
7 |
-
|
8 |
-
---
|
9 |
-
|
10 |
-
## π Features
|
11 |
-
|
12 |
-
### 1. π§ AI Script Generation
|
13 |
-
Use the built-in Qwen2.5 language model to automatically write a **concise, engaging script** based on your context and instructions.
|
14 |
-
Prefer to write your own? Just switch to "Use my script" mode.
|
15 |
-
|
16 |
-
### 2. π£οΈ Voice Generation with Kokoro
|
17 |
-
Your script is turned into a **natural-sounding AI voice** using Kokoro TTS (English voices). The voice is saved and synchronized with the final video.
|
18 |
-
|
19 |
-
### 3. ποΈ Background Video Compilation
|
20 |
-
Upload one or more `.mp4` clips to serve as the **background footage**. The app automatically stitches and syncs them to match your script duration.
|
21 |
-
|
22 |
-
### 4. π¨ Video Style Settings
|
23 |
-
Customize:
|
24 |
-
- **Brightness**
|
25 |
-
- **Contrast**
|
26 |
-
- **Gamma**
|
27 |
-
|
28 |
-
Perfect to match your aesthetic or highlight visuals better.
|
29 |
-
|
30 |
-
### 5. π΅ Optional Background Music
|
31 |
-
Optionally upload a `.mp3` music track to mix with the voiceover.
|
32 |
-
|
33 |
-
### 6. π Subtitles (Optional)
|
34 |
-
Enable dynamic subtitles that match the voiceover and are perfectly synced for better accessibility and viewer retention.
|
35 |
-
|
36 |
-
### 7. π·οΈ Title + Description + Tags
|
37 |
-
Get a **YouTube-ready title, description, and hashtags** automatically generated to improve discoverability.
|
38 |
-
|
39 |
-
---
|
40 |
-
|
41 |
-
## π§ͺ How to Use
|
42 |
-
|
43 |
-
1. Go to the **π οΈ Settings tab**:
|
44 |
-
- Enter your **context** and **instruction**
|
45 |
-
- Choose whether to auto-generate the script or input your own
|
46 |
-
- Set your desired video **duration**, **style**, and upload your background video(s)
|
47 |
-
- Optional: upload a music file and enable subtitles
|
48 |
-
|
49 |
-
2. Click **π Generate the video**
|
50 |
-
|
51 |
-
3. Head to the **π€ Results tab** to:
|
52 |
-
- Watch the generated video
|
53 |
-
- Copy the script, title, and description with one click
|
54 |
-
|
55 |
---
|
56 |
-
|
57 |
-
|
58 |
-
|
59 |
-
|
60 |
-
|
61 |
-
|
62 |
-
|
63 |
-
|
64 |
-
|
65 |
-
|
66 |
-
| Subtitles | Whisper (OpenAI) |
|
67 |
-
|
68 |
---
|
69 |
|
70 |
-
## π Project Structure
|
71 |
-
|
72 |
-
```
|
73 |
-
.
|
74 |
-
βββ app.py # Gradio app logic & interface
|
75 |
-
βββ requirements.txt # All needed dependencies
|
76 |
-
βββ README.md # This file
|
77 |
-
βββ scripts/
|
78 |
-
β βββ generate_scripts.py # Script, title, description generation
|
79 |
-
β βββ generate_voice.py # Kokoro voice synthesis
|
80 |
-
β βββ get_footage.py # Background montage builder
|
81 |
-
β βββ edit_video.py # Final audio/video editor
|
82 |
-
β βββ generate_subtitles.py # Whisper subtitle generation
|
83 |
-
βββ assets/ # Stores audio, video and outputs
|
84 |
-
```
|
85 |
-
|
86 |
-
---
|
87 |
|
88 |
-
|
89 |
-
|
90 |
-
This app requires the following dependencies (automatically installed in Spaces):
|
91 |
-
|
92 |
-
```txt
|
93 |
-
gradio
|
94 |
-
torch
|
95 |
-
transformers
|
96 |
-
kokoro>=0.9.4
|
97 |
-
soundfile
|
98 |
-
pydub
|
99 |
-
openai-whisper
|
100 |
-
moviepy
|
101 |
-
python-dotenv
|
102 |
-
```
|
103 |
-
|
104 |
-
---
|
105 |
-
|
106 |
-
## π€ Credits
|
107 |
-
|
108 |
-
Built by [Your Name or Team]
|
109 |
-
Powered by Hugging Face π€, Qwen, and Kokoro TTS
|
110 |
-
MIT License
|
111 |
-
|
112 |
-
---
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
1 |
---
|
2 |
+
title: Light AI Video Generator
|
3 |
+
emoji: π
|
4 |
+
colorFrom: indigo
|
5 |
+
colorTo: emerald
|
6 |
+
sdk: gradio
|
7 |
+
sdk_version: 5.26.0
|
8 |
+
app_file: app.py
|
9 |
+
pinned: true
|
10 |
+
license: mit
|
11 |
+
short_description: Create short videos from text with AI voice, script, background, and subtitles.
|
|
|
|
|
12 |
---
|
13 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
14 |
|
15 |
+
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|