Spaces:
Running
Running
Update GhostPackDemo/readme.md
Browse files- GhostPackDemo/readme.md +33 -29
GhostPackDemo/readme.md
CHANGED
|
@@ -2,7 +2,29 @@
|
|
| 2 |
|
| 3 |
**Generate cinematic 30 FPS AI videos from a single image on your own GPU.**
|
| 4 |
|
| 5 |
-
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 6 |
|
| 7 |
---
|
| 8 |
|
|
@@ -14,35 +36,17 @@ Upload any starter image, enter a text prompt, and receive a 30 FPS MP4 clip wit
|
|
| 14 |
|
| 15 |
## 2 · Feature Matrix
|
| 16 |
|
| 17 |
-
| ✅ Feature
|
| 18 |
-
|
| 19 |
-
| Image → Video diffusion
|
| 20 |
-
| Live progress & preview
|
| 21 |
-
| VRAM-aware execution
|
| 22 |
-
| Offline HF cache
|
| 23 |
-
| One-click installer
|
| 24 |
-
| Cross-platform
|
| 25 |
-
| Permissive license
|
| 26 |
-
|
| 27 |
-
---
|
| 28 |
-
|
| 29 |
-
## 3 · Architecture Diagram
|
| 30 |
-
|
| 31 |
-
┌──────────────────┐ prompt/img ┌──────────────┐
|
| 32 |
-
│ Gradio UI │───────────────────────────▶│ AsyncStream │───┐
|
| 33 |
-
└────────┬─────────┘ └──────────────┘ │ progress
|
| 34 |
-
│video ▼
|
| 35 |
-
┌────────▼────────┐ latents ┌──────────────────────────────────┐
|
| 36 |
-
│ Diffusion Loop │◀───────────│ HunyuanVideo 3D Transformer │
|
| 37 |
-
└─────────────────┘ preview └──────────────────────────────────┘
|
| 38 |
|
| 39 |
---
|
| 40 |
|
| 41 |
-
##
|
| 42 |
|
| 43 |
-
```bash
|
| 44 |
-
git clone https://huggingface.co/spaces/ghostai1/GhostPack.git
|
| 45 |
-
cd GhostPack/GhostPackDemo
|
| 46 |
-
./install.py # creates venv, installs deps, caches model
|
| 47 |
-
source venv/bin/activate # Windows → venv\Scripts\Activate.ps1
|
| 48 |
-
python ghostpack.py --inbrowser
|
|
|
|
| 2 |
|
| 3 |
**Generate cinematic 30 FPS AI videos from a single image on your own GPU.**
|
| 4 |
|
| 5 |
+
<p align="center">
|
| 6 |
+
<img src="https://img.shields.io/badge/python-3.8%2B-blue?logo=python">
|
| 7 |
+
<img src="https://img.shields.io/badge/license-Apache%202.0-green">
|
| 8 |
+
<img src="https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange">
|
| 9 |
+
</p>
|
| 10 |
+
|
| 11 |
+
---
|
| 12 |
+
|
| 13 |
+
## ⚡ Showcase
|
| 14 |
+
|
| 15 |
+
<p align="center">
|
| 16 |
+
<!-- 🔄 Replace `assets/demo.gif` with your actual demo GIF -->
|
| 17 |
+
<img src="assets/demo.gif" alt="GhostPackDemo animated example" style="max-width:100%; height:auto;">
|
| 18 |
+
</p>
|
| 19 |
+
|
| 20 |
+
<table>
|
| 21 |
+
<tr>
|
| 22 |
+
<!-- 🖼 Replace each src with your real screenshot paths -->
|
| 23 |
+
<td align="center"><img src="assets/screenshot1.png" width="260"><br><sub>📸 Main UI</sub></td>
|
| 24 |
+
<td align="center"><img src="assets/screenshot2.png" width="260"><br><sub>📸 Progress Preview</sub></td>
|
| 25 |
+
<td align="center"><img src="assets/screenshot3.png" width="260"><br><sub>📸 Finished Video</sub></td>
|
| 26 |
+
</tr>
|
| 27 |
+
</table>
|
| 28 |
|
| 29 |
---
|
| 30 |
|
|
|
|
| 36 |
|
| 37 |
## 2 · Feature Matrix
|
| 38 |
|
| 39 |
+
| ✅ Feature | Description |
|
| 40 |
+
|------------------------------|------------------------------------------------------------------------------------|
|
| 41 |
+
| Image → Video diffusion | Full diffusion loop conditioned on image **and** text |
|
| 42 |
+
| Live progress & preview | Real-time denoise frames + HTML progress bar |
|
| 43 |
+
| VRAM-aware execution | Automatic slicing/offload when free VRAM < 60 GB |
|
| 44 |
+
| Offline HF cache | Models stored once in `hf_download/` |
|
| 45 |
+
| One-click installer | `install.py` builds venv, installs deps, logs in to HF, downloads models |
|
| 46 |
+
| Cross-platform | Linux 🐧 · WSL · Windows 🪟 (PowerShell) |
|
| 47 |
+
| Permissive license | Distributed under **Apache 2.0** — free for commercial & non-commercial use |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 48 |
|
| 49 |
---
|
| 50 |
|
| 51 |
+
## 3 · Architecture (High-Level)
|
| 52 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|