ghostai1 commited on
Commit
77f18e1
·
verified ·
1 Parent(s): f811be7

Update GhostPackDemo/readme.md

Browse files
Files changed (1) hide show
  1. GhostPackDemo/readme.md +24 -78
GhostPackDemo/readme.md CHANGED
@@ -1,5 +1,5 @@
1
  # 👻🎬 GhostPackDemo · Apache-2.0
2
- Generate cinematic **30 FPS** AI videos from a single image—runs locally on your GPU with ease.
3
  [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
4
  [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
5
  [![HF Space](https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange)](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 integrates **HunyuanVideo** and **FramePack** into a streamlined GPU pipeline (`ghostpack_main_fixed.py`) with a user-friendly **Gradio** UI. Create photorealistic videos using GPUs with ≥6GB VRAM, optimized for 8GB RAM laptops.
11
 
12
  ## Features
13
- - **Veo 3-Level AI**: Delivers hyper-realistic videos with next-frame prediction and smooth transitions.
14
- - **Phantom Speed**: Teacache reduces rendering time by ~40% (~12-15s/frame on RTX 3060).
15
- - **Laptop Domination**: Supports 13B models on ≥6GB VRAM GPUs (e.g., RTX 3060).
16
- - **Custom Workflows**: Adjust frame length, batch size, and prompts to suit your creativity.
17
- - **Live Preview**: View real-time frame previews in ghostgradio.py.
18
- - **Open Source**: Enhanced by community contributions under Apache 2.0.
19
 
20
  ## Optimizations
21
- - **Speed**:
22
- - Teacache: ~40% faster (\( T_{\text{total}} \approx 0.6 \cdot T_{\text{base}} \)).
23
- - Sage-Attention: ~5-10% faster (\( T_{\text{attn}} \approx 0.9 \cdot T_{\text{base_attn}} \)).
24
- - CUDA Tweaks: ~10-15% latency reduction (\( L_{\text{CUDA}} \approx 0.85 \cdot L_{\text{base}} \)).
25
- - Dynamic Scheduling: ~15-20% task time reduction (\( T_{\text{sched}} \approx 0.8 \cdot T_{\text{base_sched}} \)).
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
- Experience GhostPack’s spectral video generation with a neon-lit spectral battle scene sample. [More Demos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos).
39
 
40
  ## Future
41
- - **Voice Generation**: AI-driven voice synthesis for narrated videos.
42
- - **AI Images**: High-quality starting frames with AI visuals.
43
- - **VR Integration**: Future support for VR video rendering.
44
 
45
  ## Installation & How-To
46
- Requires >30GB disk, compatible hardware. Ubuntu: bash git clone https://github.com/ghostai1/GhostPack cd GhostPack chmod +x install_ubuntu.sh ./install_ubuntu.sh (NVIDIA GPU, 8GB RAM, Python 3.10, CUDA 12.6) Windows: bash git clone https://github.com/ghostai1/GhostPack cd GhostPack install.bat (Auto-downloads >30GB models, needs NVIDIA drivers) macOS: bash git clone https://github.com/ghostai1/GhostPack cd GhostPack chmod +x install_macos.sh ./install_macos.sh (M1/M2 support, slower with Metal) How-To: Launch GUI: bash source ~/ghostpack_venv/venv/bin/activate cd ~/ghostpack_venv python ghostgradio.py --port 5666 --server 0.0.0.0 Craft Spells: Upload an image, use prompt “A spectral figure glides through a neon-lit city,” enable teacache, set 15fps, 5s video. Summon Spirits: Monitor with nvidia-smi (~80-100% GPU usage). Export Results: Save MP4 with adjustable CRF (0-100). Latest Release: [Link](https://github.com/ghostai1/GhostPack/releases).
47
-
48
- ## Community
49
- - **Discord**: [Join Now](https://discord.gg/ghostpack) for support.
50
- - **Report Issues**: [Link](https://github.com/ghostai1/GhostPack/issues).
51
-
52
- ## Technical Deep Dive
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
  [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
4
  [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
5
  [![HF Space](https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange)](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