Spaces:
Running
Running
Update GhostPackDemo/readme.md
Browse files- GhostPackDemo/readme.md +69 -65
GhostPackDemo/readme.md
CHANGED
@@ -1,6 +1,6 @@
|
|
1 |
-
# π» GhostPackDemo: Next-Gen AI Video
|
2 |
|
3 |
-
**Create real
|
4 |
[](https://python.org)
|
5 |
[](LICENSE)
|
6 |
[](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
|
@@ -9,75 +9,80 @@
|
|
9 |
|
10 |
## π What is GhostPackDemo?
|
11 |
|
12 |
-
GhostPackDemo is
|
13 |
-
No cloud, no rental GPUs: **make stunning, smooth videos on your own hardware** (6GB+ VRAM/8GB+ RAM).
|
14 |
|
15 |
-
- **
|
16 |
-
- **
|
17 |
-
- **
|
18 |
-
- **
|
19 |
-
- **
|
20 |
|
21 |
---
|
22 |
|
23 |
## β¨ Features
|
24 |
|
25 |
-
- **Veo 3-Level AI
|
26 |
-
- **Phantom Speed
|
27 |
-
- **
|
28 |
-
- **
|
29 |
-
- **
|
30 |
-
- **Community Built**: Free, extensible, remixable
|
31 |
|
32 |
---
|
33 |
|
34 |
-
##
|
35 |
-
|
36 |
-
- **Speed
|
37 |
-
- Teacache: ~40% faster (`T_total β 0.6 Γ T_base`)
|
38 |
-
- Sage-Attention:
|
39 |
-
- CUDA tweaks: β15% latency
|
40 |
-
- Dynamic scheduling: β20%
|
41 |
-
- **Memory
|
42 |
-
- Context packing: β50% VRAM
|
43 |
-
- tcmalloc: β20% overhead
|
44 |
-
-
|
45 |
-
- **Compute
|
46 |
-
- Dynamic batching: +50% throughput
|
47 |
-
- **Efficiency
|
48 |
-
- Power
|
49 |
-
- Thread tuning: +15% CPU
|
50 |
-
- **VRAM Needs
|
51 |
-
- GTX 1650 (6GB): 18β25s/frame
|
52 |
-
- RTX 3050 (8GB): 15β20s/frame
|
53 |
-
- RTX 3060 (12GB): 10β15s/frame
|
54 |
-
- RTX 4090 (24GB): 1.5β2.5s/frame
|
|
|
|
|
|
|
55 |
|
56 |
---
|
57 |
|
58 |
## πΊ Demos & Screenshots
|
59 |
|
60 |
-
<div align="center">
|
|
|
|
|
|
|
|
|
|
|
|
|
61 |
|
62 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d
|
63 |
-
<br>
|
64 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/7ABE2lOA4LOUtPfh1mhxP.png" alt="Main Interface" width="310" style="margin:12px; border-radius:12px; box-shadow:0 0 16px #00ffcc;">
|
65 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/9qNVRX2eM2iCY8xQKcOwW.png" alt="Advanced Settings" width="310" style="margin:12px; border-radius:12px; box-shadow:0 0 16px #00ffcc;">
|
66 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/--fIS9ITg4-VqN22ySoa2.png" alt="Logs Display" width="310" style="margin:12px; border-radius:12px; box-shadow:0 0 16px #00ffcc;">
|
67 |
|
68 |
</div>
|
69 |
|
70 |
-
>
|
|
|
|
|
|
|
|
|
71 |
|
72 |
-
See more: [Demo Videos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos)
|
73 |
|
74 |
---
|
75 |
|
76 |
## π οΈ Installation
|
77 |
|
78 |
-
**
|
79 |
-
|
80 |
-
### Ubuntu
|
81 |
```bash
|
82 |
git clone https://github.com/ghostai1/GhostPack
|
83 |
cd GhostPack
|
@@ -85,14 +90,14 @@ chmod +x install_ubuntu.sh
|
|
85 |
./install_ubuntu.sh
|
86 |
```
|
87 |
|
88 |
-
|
89 |
```bash
|
90 |
git clone https://github.com/ghostai1/GhostPack
|
91 |
cd GhostPack
|
92 |
install.bat
|
93 |
```
|
94 |
|
95 |
-
|
96 |
```bash
|
97 |
git clone https://github.com/ghostai1/GhostPack
|
98 |
cd GhostPack
|
@@ -109,40 +114,39 @@ source ~/ghostpack_venv/bin/activate
|
|
109 |
cd ~/ghostpack_venv
|
110 |
python ghostgradio.py --port 5666 --server 0.0.0.0
|
111 |
```
|
112 |
-
|
113 |
-
-
|
114 |
-
-
|
115 |
-
-
|
116 |
-
-
|
117 |
-
- **Monitor GPU:** run `nvidia-smi` for full load.
|
118 |
|
119 |
---
|
120 |
|
121 |
## π Roadmap
|
122 |
|
123 |
-
- **AI Voice Generation**: Narrate
|
124 |
-
- **AI
|
125 |
-
- **VR
|
126 |
|
127 |
---
|
128 |
|
129 |
-
## π€ Community
|
130 |
|
131 |
-
- [Discord](https://discord.gg/ghostpack) β Support
|
132 |
-
- [GitHub Issues](https://github.com/ghostai1/GhostPack/issues) β Report bugs
|
133 |
-
- [Hugging Face Space](https://huggingface.co/spaces/ghostai1/GhostPackDemo) β
|
134 |
|
135 |
---
|
136 |
|
137 |
## π§βπ» Contributing
|
138 |
|
139 |
-
- Fork
|
140 |
-
-
|
141 |
|
142 |
---
|
143 |
|
144 |
## π License
|
145 |
|
146 |
-
Apache 2.0
|
147 |
**GhostPack by [ghostai1](https://github.com/ghostai1/GhostPack) Β· [Hugging Face](https://huggingface.co/ghostai1)**
|
148 |
*Created June 11, 2025*
|
|
|
1 |
+
# π» GhostPackDemo: Next-Gen AI Video Generator
|
2 |
|
3 |
+
**Create real 30 FPS AI videos from a single image on your own GPU**
|
4 |
[](https://python.org)
|
5 |
[](LICENSE)
|
6 |
[](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
|
|
|
9 |
|
10 |
## π What is GhostPackDemo?
|
11 |
|
12 |
+
**GhostPackDemo** is an open-source, GPU-optimized AI video generator. It fuses **HunyuanVideo** and **FramePack** into a single streamlined pipeline with a beautiful Gradio UI.
|
|
|
13 |
|
14 |
+
- **Ultra Fast:** Up to 40% faster thanks to Teacache, Sage-Attention, and dynamic batching.
|
15 |
+
- **Resource-Smart:** 50% lower VRAM (context packing, tcmalloc, memory cache).
|
16 |
+
- **Laptop-Friendly:** Works with 6GB VRAM, 8GB RAM (e.g., GTX 1650, RTX 3050/3060).
|
17 |
+
- **No Cloud Needed:** Run on your local desktop, server, or laptop.
|
18 |
+
- **Full Control:** Live preview, prompt/batch/frame/CRF settings, instant exports.
|
19 |
|
20 |
---
|
21 |
|
22 |
## β¨ Features
|
23 |
|
24 |
+
- **Veo 3-Level AI:** Next-frame video prediction for photorealistic motion.
|
25 |
+
- **Phantom Speed:** Teacache & Sage-Attention = 12β15s/frame (RTX 3060).
|
26 |
+
- **Batch & Prompt Tuning:** Full workflow control, see frames build in real time.
|
27 |
+
- **Open Source:** Apache 2.0, remix, extend, contribute.
|
28 |
+
- **Export Quality:** MP4 with customizable CRF (0β100).
|
|
|
29 |
|
30 |
---
|
31 |
|
32 |
+
## π§ Optimizations & Requirements
|
33 |
+
|
34 |
+
- **Speed**
|
35 |
+
- Teacache: ~40% faster (`T_total β 0.6 Γ T_base`)
|
36 |
+
- Sage-Attention: +10%
|
37 |
+
- CUDA tweaks: β15% latency
|
38 |
+
- Dynamic scheduling: β20% time
|
39 |
+
- **Memory**
|
40 |
+
- Context packing: β50% VRAM
|
41 |
+
- tcmalloc: β20% overhead
|
42 |
+
- Memory cache: β25% VRAM swap
|
43 |
+
- **Compute**
|
44 |
+
- Dynamic batching: +50% throughput
|
45 |
+
- **Efficiency**
|
46 |
+
- Power saving: β30% idle power
|
47 |
+
- Thread tuning: +15% CPU
|
48 |
+
- **VRAM Needs**
|
49 |
+
- GTX 1650 (6GB): 18β25s/frame
|
50 |
+
- RTX 3050 (8GB): 15β20s/frame
|
51 |
+
- RTX 3060 (12GB): 10β15s/frame
|
52 |
+
- RTX 4090 (24GB): 1.5β2.5s/frame
|
53 |
+
|
54 |
+
**Minimum**: NVIDIA GPU (6GB+ VRAM), 8GB RAM, 30GB free disk, Python 3.10+, CUDA 12.6+
|
55 |
+
**Optimal**: RTX 3060 or higher
|
56 |
|
57 |
---
|
58 |
|
59 |
## πΊ Demos & Screenshots
|
60 |
|
61 |
+
<div align="center" style="display: flex; flex-direction: row; flex-wrap: nowrap; gap: 22px; align-items: center;">
|
62 |
+
|
63 |
+
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/k8pgUlg4OvdUZpbMNTcp5.gif" alt="GhostPack Demo GIF" style="width: 420px; height: auto; border-radius: 14px; box-shadow: 0 0 32px #ff00ff; margin-bottom: 12px;">
|
64 |
+
|
65 |
+
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/7ABE2lOA4LOUtPfh1mhxP.png" alt="Main Interface" style="width: 260px; height: auto; border-radius: 12px; box-shadow: 0 0 18px #00ffcc; margin-bottom: 12px;">
|
66 |
+
|
67 |
+
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/9qNVRX2eM2iCY8xQKcOwW.png" alt="Advanced Settings" style="width: 260px; height: auto; border-radius: 12px; box-shadow: 0 0 18px #00ffcc; margin-bottom: 12px;">
|
68 |
|
69 |
+
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/--fIS9ITg4-VqN22ySoa2.png" alt="Logs Display" style="width: 260px; height: auto; border-radius: 12px; box-shadow: 0 0 18px #00ffcc; margin-bottom: 12px;">
|
|
|
|
|
|
|
|
|
70 |
|
71 |
</div>
|
72 |
|
73 |
+
<div align="center">
|
74 |
+
<sub>
|
75 |
+
<strong>Demo GIF</strong> β’ <strong>Main Interface</strong> β’ <strong>Advanced Settings</strong> β’ <strong>Logs</strong>
|
76 |
+
</sub>
|
77 |
+
</div>
|
78 |
|
79 |
+
> See more: [Demo Videos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos)
|
80 |
|
81 |
---
|
82 |
|
83 |
## π οΈ Installation
|
84 |
|
85 |
+
**Ubuntu**
|
|
|
|
|
86 |
```bash
|
87 |
git clone https://github.com/ghostai1/GhostPack
|
88 |
cd GhostPack
|
|
|
90 |
./install_ubuntu.sh
|
91 |
```
|
92 |
|
93 |
+
**Windows**
|
94 |
```bash
|
95 |
git clone https://github.com/ghostai1/GhostPack
|
96 |
cd GhostPack
|
97 |
install.bat
|
98 |
```
|
99 |
|
100 |
+
**macOS**
|
101 |
```bash
|
102 |
git clone https://github.com/ghostai1/GhostPack
|
103 |
cd GhostPack
|
|
|
114 |
cd ~/ghostpack_venv
|
115 |
python ghostgradio.py --port 5666 --server 0.0.0.0
|
116 |
```
|
117 |
+
- Upload an image and enter your prompt
|
118 |
+
- Set FPS, batch size, video length, CRF, enable Teacache
|
119 |
+
- Watch your video build in real-time preview
|
120 |
+
- Export to MP4, any quality
|
121 |
+
- Monitor GPU usage: `nvidia-smi`
|
|
|
122 |
|
123 |
---
|
124 |
|
125 |
## π Roadmap
|
126 |
|
127 |
+
- **AI Voice Generation**: Narrate videos with custom voices
|
128 |
+
- **AI Start Images**: Generate ultra-high-res starting frames
|
129 |
+
- **Native VR**: Experimental 3D/VR video support
|
130 |
|
131 |
---
|
132 |
|
133 |
+
## π€ Community & Support
|
134 |
|
135 |
+
- [Discord](https://discord.gg/ghostpack) β Support & collabs
|
136 |
+
- [GitHub Issues](https://github.com/ghostai1/GhostPack/issues) β Report bugs & request features
|
137 |
+
- [Hugging Face Space](https://huggingface.co/spaces/ghostai1/GhostPackDemo) β Live web demo
|
138 |
|
139 |
---
|
140 |
|
141 |
## π§βπ» Contributing
|
142 |
|
143 |
+
- Fork, branch, PR. All improvements welcome!
|
144 |
+
- See [CONTRIBUTING.md](https://github.com/ghostai1/GhostPack/blob/main/CONTRIBUTING.md)
|
145 |
|
146 |
---
|
147 |
|
148 |
## π License
|
149 |
|
150 |
+
Apache 2.0
|
151 |
**GhostPack by [ghostai1](https://github.com/ghostai1/GhostPack) Β· [Hugging Face](https://huggingface.co/ghostai1)**
|
152 |
*Created June 11, 2025*
|