ghostai1 commited on
Commit
285fc8c
Β·
verified Β·
1 Parent(s): 8f926f1

Update GhostPackDemo/readme.md

Browse files
Files changed (1) hide show
  1. GhostPackDemo/readme.md +69 -65
GhostPackDemo/readme.md CHANGED
@@ -1,6 +1,6 @@
1
- # πŸ‘» GhostPackDemo: Next-Gen AI Video Engine
2
 
3
- **Create real 30FPS AI videos from a single image on any modern GPU!**
4
  [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
5
  [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
6
  [![Live Demo](https://img.shields.io/badge/πŸ€—%20Spaces-Live%20Demo-orange)](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
@@ -9,75 +9,80 @@
9
 
10
  ## πŸš€ What is GhostPackDemo?
11
 
12
- GhostPackDemo is a **laptop-friendly, open-source AI video generator** that merges HunyuanVideo and FramePack into one supercharged pipeline with an intuitive Gradio UI.
13
- No cloud, no rental GPUs: **make stunning, smooth videos on your own hardware** (6GB+ VRAM/8GB+ RAM).
14
 
15
- - **Blazing Fast**: Up to 40% faster with Teacache & Sage-Attention
16
- - **Efficient**: 50% less VRAM required (context packing, batching, tcmalloc, cache tricks)
17
- - **Customizable**: Control every parameter, live preview, tune batch size & prompts
18
- - **Real Results**: 10–15s/frame (RTX 3060), full 30FPS from one photo
19
- - **Fully Open Source**: Apache 2.0
20
 
21
  ---
22
 
23
  ## ✨ Features
24
 
25
- - **Veo 3-Level AI**: Advanced frame prediction for lifelike motion
26
- - **Phantom Speed**: 12–15s/frame (RTX 3060), up to 50% throughput boost with dynamic batching
27
- - **Laptop & Desktop Ready**: Works on 6GB/8GB+ VRAM (GTX 1650 and up)
28
- - **Custom Workflow**: Batch, frame count, prompt, CRFβ€”dial it all in
29
- - **Instant Preview**: See frames as they're built (Gradio)
30
- - **Community Built**: Free, extensible, remixable
31
 
32
  ---
33
 
34
- ## πŸ§™β€β™‚οΈ Math Sorcery (Optimizations)
35
-
36
- - **Speed**:
37
- - Teacache: ~40% faster (`T_total β‰ˆ 0.6 Γ— T_base`)
38
- - Sage-Attention: 5–10% faster
39
- - CUDA tweaks: –15% latency
40
- - Dynamic scheduling: –20% gen time
41
- - **Memory**:
42
- - Context packing: –50% VRAM
43
- - tcmalloc: –20% overhead
44
- - VRAM cache: –25% swap ops
45
- - **Compute**:
46
- - Dynamic batching: +50% throughput
47
- - **Efficiency**:
48
- - Power savings: –30% idle draw
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/k8pgUlg4OvdUZpbMNTcp5.gif" alt="GhostPack Demo GIF" style="max-width: 480px; border-radius: 14px; box-shadow: 0 0 30px #ff00ff; margin-bottom: 20px;">
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
- > **Main Interface Β· Advanced Settings Β· Logs**
 
 
 
 
71
 
72
- See more: [Demo Videos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos)
73
 
74
  ---
75
 
76
  ## πŸ› οΈ Installation
77
 
78
- **Requires:** NVIDIA GPU (6GB+ VRAM), 8GB+ RAM, 30GB+ disk, Python 3.10, CUDA 12.6+
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
- ### Windows
89
  ```bash
90
  git clone https://github.com/ghostai1/GhostPack
91
  cd GhostPack
92
  install.bat
93
  ```
94
 
95
- ### macOS
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
- - **Upload an image**, set your prompt, choose batch size/FPS/CRF.
114
- - **Enable Teacache** for best speed.
115
- - **Watch the live preview.**
116
- - **Export your video** (MP4, any quality).
117
- - **Monitor GPU:** run `nvidia-smi` for full load.
118
 
119
  ---
120
 
121
  ## 🌟 Roadmap
122
 
123
- - **AI Voice Generation**: Narrate your videos with custom AI voices
124
- - **AI Image Creation**: Start with pro-quality AI-generated frames
125
- - **VR Video**: Native support for 3D/VR video rendering
126
 
127
  ---
128
 
129
- ## 🀝 Community
130
 
131
- - [Discord](https://discord.gg/ghostpack) β€” Support, collabs, & feedback
132
- - [GitHub Issues](https://github.com/ghostai1/GhostPack/issues) β€” Report bugs, request features
133
- - [Hugging Face Space](https://huggingface.co/spaces/ghostai1/GhostPackDemo) β€” Try the demo live
134
 
135
  ---
136
 
137
  ## πŸ§‘β€πŸ’» Contributing
138
 
139
- - Fork & branch, submit PRs, follow [CONTRIBUTING.md](https://github.com/ghostai1/GhostPack/blob/main/CONTRIBUTING.md)
140
- - All improvements welcomeβ€”GUI, docs, optimization, features
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
  [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
5
  [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
6
  [![Live Demo](https://img.shields.io/badge/πŸ€—%20Spaces-Live%20Demo-orange)](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> &nbsp; β€’ &nbsp; <strong>Main Interface</strong> &nbsp; β€’ &nbsp; <strong>Advanced Settings</strong> &nbsp; β€’ &nbsp; <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*