ghostai1 commited on
Commit
87012c1
·
verified ·
1 Parent(s): dc0adaa

Update GhostPackDemo/readme.md

Browse files
Files changed (1) hide show
  1. GhostPackDemo/readme.md +25 -30
GhostPackDemo/readme.md CHANGED
@@ -1,52 +1,47 @@
1
- # 👻🎬 GhostPackDemo · Apache-2.0
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
 
31
  ## 1 · Overview
32
- GhostPackDemo wraps **HunyuanVideo** + **FramePack** into a single-file GPU pipeline (`ghostpack.py`) with an intuitive **Gradio** UI.
33
- Upload any starter image, enter a text prompt, and receive a 30 FPS MP4 clip with live denoising preview.
34
 
35
  ---
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 &lt; 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
 
 
1
+ # 👻🎬 GhostPackDemo · Apache 2.0
2
 
3
+ Generate cinematic **30 FPS** AI videos from a single image—runs locally on your GPU.
4
 
5
+ [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
6
+ [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
7
+ [![HF Space](https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange)](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
 
 
8
 
9
  ---
10
 
11
+ ## ⚡ Showcase
12
 
13
  <p align="center">
14
+ <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/k8pgUlg4OvdUZpbMNTcp5.gif"
15
+ alt="GhostPackDemo animated example" style="max-width:100%;height:auto;">
16
  </p>
17
 
18
+ <p align="center">
19
+ <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/7ABE2lOA4LOUtPfh1mhxP.png" width="30%" alt="Main UI">
20
+ <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/9qNVRX2eM2iCY8xQKcOwW.png" width="30%" alt="Progress Preview">
21
+ <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/--fIS9ITg4-VqN22ySoa2.png" width="30%" alt="Finished Video">
22
+ </p>
 
 
 
23
 
24
  ---
25
 
26
  ## 1 · Overview
27
+ GhostPackDemo bundles **HunyuanVideo** + **FramePack** into a single-script GPU pipeline (`ghostpack.py`) with an intuitive **Gradio** UI.
28
+ Upload any starter image, enter a prompt, and receive a 30 FPS MP4 clip with live denoising preview.
29
 
30
  ---
31
 
32
  ## 2 · Feature Matrix
33
 
34
+ | ✅ Feature | Description |
35
+ |---------------------------|--------------------------------------------------------------------------------|
36
+ | Image → Video diffusion | Full diffusion loop conditioned on image **and** text |
37
+ | Live progress & preview | Real-time denoise frames + progress bar |
38
+ | VRAM-aware execution | Automatic slicing/offload when free VRAM &lt; 60 GB |
39
+ | Offline HF cache | Models cached once in `hf_download/` |
40
+ | One-click installer | `install.py` builds venv, installs deps, logs in to HF, downloads models |
41
+ | Cross-platform | Linux 🐧 · WSL · Windows 🪟 (PowerShell) |
42
+ | Permissive license | Distributed under **Apache 2.0**—commercial & non-commercial use allowed |
43
 
44
  ---
45
 
46
+ ## 3 · Architecture
47