Spaces:
Running
Running
Update GhostPackDemo/readme.md
Browse files- GhostPackDemo/readme.md +24 -78
GhostPackDemo/readme.md
CHANGED
@@ -1,5 +1,5 @@
|
|
1 |
# 👻🎬 GhostPackDemo · Apache-2.0
|
2 |
-
|
3 |
[](https://python.org)
|
4 |
[](LICENSE)
|
5 |
[](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
|
@@ -7,90 +7,36 @@ Generate cinematic **30 FPS** AI videos from a single image—runs locally on yo
|
|
7 |
---
|
8 |
|
9 |
## Overview
|
10 |
-
GhostPackDemo
|
11 |
|
12 |
## Features
|
13 |
-
- **Veo 3-Level AI**:
|
14 |
-
- **Phantom Speed**: Teacache
|
15 |
-
- **Laptop
|
16 |
-
- **
|
17 |
-
- **Live Preview**:
|
18 |
-
- **Open Source**:
|
19 |
|
20 |
## Optimizations
|
21 |
-
- **Speed**:
|
22 |
-
|
23 |
-
|
24 |
-
|
25 |
-
|
26 |
-
- **Memory**:
|
27 |
-
- Context Packing: ~50% VRAM save (\( M_{\text{VRAM}} \propto O(1) \)).
|
28 |
-
- tcmalloc: ~5-20% overhead reduction (\( O_{\text{mem}} \approx 0.8 \cdot O_{\text{glibc}} \)).
|
29 |
-
- Memory Cache: ~25% fewer swaps (\( M_{\text{swap}} \approx 0.75 \cdot M_{\text{base_swap}} \)).
|
30 |
-
- **Compute**:
|
31 |
-
- Dynamic Batching: ~30-50% throughput increase (\( \text{Throughput} \propto B \cdot \text{FPS}_{\text{base}} \)).
|
32 |
-
- **Efficiency**:
|
33 |
-
- Power Optimization: ~20-30% power save (\( P_{\text{idle}} \approx 0.7 \cdot P_{\text{base_idle}} \)).
|
34 |
-
- Thread Tuning: ~10-15% CPU boost (\( C_{\text{thread}} \approx 0.85 \cdot C_{\text{base_thread}} \)).
|
35 |
-
- **VRAM Requirements**: GTX 1650 (6GB, ~18-25s/frame), RTX 3050 (8GB, ~15-20s/frame), RTX 3060 (12GB, ~10-15s/frame), RTX 4090 (24GB, ~1.5-2.5s/frame).
|
36 |
|
37 |
## Demo
|
38 |
-
|
39 |
|
40 |
## Future
|
41 |
-
- **Voice Generation**: AI-
|
42 |
-
- **AI Images**:
|
43 |
-
- **VR Integration**:
|
44 |
|
45 |
## Installation & How-To
|
46 |
-
|
47 |
-
|
48 |
-
|
49 |
-
|
50 |
-
|
51 |
-
|
52 |
-
|
53 |
-
- **Architecture**: Built on HunyuanVideo and FramePackI2V_HY with LlamaModel and CLIPTextModel.
|
54 |
-
- **Pipeline**: Uses k-diffusion with unipc for high-quality frame generation.
|
55 |
-
- **Wiki**: [Link](https://github.com/ghostai1/GhostPack/wiki).
|
56 |
-
|
57 |
-
## FAQ
|
58 |
-
- **Hardware**: Minimum 6GB VRAM (GTX 1650), 8GB RAM; Optimal 12GB VRAM (RTX 3060).
|
59 |
-
- **Install**: Clone and run the appropriate install script (e.g., ./install_ubuntu.sh).
|
60 |
-
- **Contribute**: Yes, see Contributing Guidelines.
|
61 |
-
|
62 |
-
## Tutorials
|
63 |
-
- **Getting Started**: [View](https://github.com/ghostai1/GhostPack/wiki/Getting-Started).
|
64 |
-
- **Advanced Configuration**: [View](https://github.com/ghostai1/GhostPack/wiki/Advanced-Configuration).
|
65 |
-
- **Video Export Tips**: [View](https://github.com/ghostai1/GhostPack/wiki/Video-Export-Tips).
|
66 |
-
- **More Tutorials**: [Link](https://github.com/ghostai1/GhostPack/wiki/Tutorials).
|
67 |
-
|
68 |
-
## Contribute
|
69 |
-
- Fork the repository, create a branch, submit pull requests, follow wiki standards, and test with ghostgradio.py.
|
70 |
-
- **Guidelines**: [Link](https://github.com/ghostai1/GhostPack/blob/main/CONTRIBUTING.md).
|
71 |
-
|
72 |
-
## Screenshots
|
73 |
-
- **Main Interface**:
|
74 |
-
<p align="center">
|
75 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/7ABE2lOA4LOUtPfh1mhxP.png" alt="Main Interface" style="max-width:100%; height:auto;">
|
76 |
-
</p>
|
77 |
-
- **Advanced Settings**:
|
78 |
-
<p align="center">
|
79 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/9qNVRX2eM2iCY8xQKcOwW.png" alt="Advanced Settings" style="max-width:100%; height:auto;">
|
80 |
-
</p>
|
81 |
-
- **Logs Display**:
|
82 |
-
<p align="center">
|
83 |
-
<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/--fIS9ITg4-VqN22ySoa2.png" alt="Logs Display" style="max-width:100%; height:auto;">
|
84 |
-
</p>
|
85 |
-
Add your own to showcase projects!
|
86 |
-
|
87 |
-
## Latest Files
|
88 |
-
- **Latest File**: [ghostgradio.py](https://github.com/ghostai1/GhostPack/blob/main/ghostgradio.py).
|
89 |
-
- **Logs**: [View](https://github.com/ghostai1/GhostPack/tree/main/outputs).
|
90 |
-
- **Refresh Repo**: [Link](https://github.com/ghostai1/GhostPack) | **Refresh Logs**: [Link](https://github.com/ghostai1/GhostPack/tree/main/outputs).
|
91 |
-
|
92 |
-
## License
|
93 |
-
Distributed under Apache 2.0. See [LICENSE](LICENSE) for details.
|
94 |
-
|
95 |
-
👻 GhostPack by ghostai1 | [GitHub](https://github.com/ghostai1/GhostPack) | [Hugging Face](https://huggingface.co/spaces/ghostai1/GhostPack)
|
96 |
-
Created 07:31 PM CDT, June 11, 2025 😈⚡️
|
|
|
1 |
# 👻🎬 GhostPackDemo · Apache-2.0
|
2 |
+
Create stunning **30 FPS** AI videos from a single image with local GPU processing.
|
3 |
[](https://python.org)
|
4 |
[](LICENSE)
|
5 |
[](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
|
|
|
7 |
---
|
8 |
|
9 |
## Overview
|
10 |
+
GhostPackDemo combines **HunyuanVideo** and **FramePack** into a single GPU pipeline (`ghostpack_main_fixed.py`) with an intuitive **Gradio** UI. Perfect for generating photorealistic videos on GPUs with ≥6GB VRAM, tailored for 8GB RAM laptops.
|
11 |
|
12 |
## Features
|
13 |
+
- **Veo 3-Level AI**: Produces hyper-realistic videos with seamless next-frame prediction.
|
14 |
+
- **Phantom Speed**: Teacache boosts speed by ~40% (~12-15s/frame on RTX 3060).
|
15 |
+
- **Laptop-Friendly**: Runs 13B models on ≥6GB VRAM GPUs (e.g., RTX 3060).
|
16 |
+
- **Customizable Workflows**: Fine-tune frame length, batch size, and prompts.
|
17 |
+
- **Live Preview**: Real-time frame previews via ghostgradio.py.
|
18 |
+
- **Open Source**: Community-supported under Apache 2.0.
|
19 |
|
20 |
## Optimizations
|
21 |
+
- **Speed**: Teacache (~40% faster, \( T_{\text{total}} \approx 0.6 \cdot T_{\text{base}} \)), Sage-Attention (~5-10% faster, \( T_{\text{attn}} \approx 0.9 \cdot T_{\text{base_attn}} \)), CUDA Tweaks (~10-15% latency reduction, \( L_{\text{CUDA}} \approx 0.85 \cdot L_{\text{base}} \)), Dynamic Scheduling (~15-20% task time reduction, \( T_{\text{sched}} \approx 0.8 \cdot T_{\text{base_sched}} \)).
|
22 |
+
- **Memory**: Context Packing (~50% VRAM save, \( M_{\text{VRAM}} \propto O(1) \)), tcmalloc (~5-20% overhead reduction, \( O_{\text{mem}} \approx 0.8 \cdot O_{\text{glibc}} \)), Memory Cache (~25% fewer swaps, \( M_{\text{swap}} \approx 0.75 \cdot M_{\text{base_swap}} \)).
|
23 |
+
- **Compute**: Dynamic Batching (~30-50% throughput increase, \( \text{Throughput} \propto B \cdot \text{FPS}_{\text{base}} \)).
|
24 |
+
- **Efficiency**: Power Optimization (~20-30% power save, \( P_{\text{idle}} \approx 0.7 \cdot P_{\text{base_idle}} \)), Thread Tuning (~10-15% CPU boost, \( C_{\text{thread}} \approx 0.85 \cdot C_{\text{base_thread}} \)).
|
25 |
+
- **VRAM Needs**: GTX 1650 (6GB, ~18-25s/frame), RTX 3050 (8GB, ~15-20s/frame), RTX 3060 (12GB, ~10-15s/frame), RTX 4090 (24GB, ~1.5-2.5s/frame).
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
26 |
|
27 |
## Demo
|
28 |
+
See GhostPack’s magic with a neon-lit spectral battle scene video. [More Demos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos).
|
29 |
|
30 |
## Future
|
31 |
+
- **Voice Generation**: Add AI-synthesized voices for narrated videos.
|
32 |
+
- **AI Images**: Create high-quality starting frames with AI.
|
33 |
+
- **VR Integration**: Plan for VR video rendering support.
|
34 |
|
35 |
## Installation & How-To
|
36 |
+
Needs >30GB disk space and compatible hardware.
|
37 |
+
- **Ubuntu**:
|
38 |
+
```bash
|
39 |
+
git clone https://github.com/ghostai1/GhostPack
|
40 |
+
cd GhostPack
|
41 |
+
chmod +x install_ubuntu.sh
|
42 |
+
./install_ubuntu.sh
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|