Spaces:

ghostai1
/

GhostPack

Running

App Files Files Community

ghostai1 commited on Jun 12, 2025

Commit

e0b2024

verified ·

1 Parent(s): ea6acc3

Update GhostPackDemo/readme.md

Browse files

Files changed (1) hide show

GhostPackDemo/readme.md +47 -71

GhostPackDemo/readme.md CHANGED Viewed

@@ -1,88 +1,66 @@
 # 👻🎬 GhostPackDemo · Apache-2.0
-Generate cinematic **30 FPS** AI videos from a single image—runs locally on your GPU.
 [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
-[![HF Space](https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange)](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
----
-## ⚡ Showcase
-<p align="center">
-  <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/k8pgUlg4OvdUZpbMNTcp5.gif" alt="GhostPack demo GIF" style="max-width:100%; height:auto;">
-</p>
 ---
-## 1 · Overview
-GhostPackDemo bundles **HunyuanVideo** + **FramePack** into a single-script GPU pipeline (`ghostpack_main_fixed.py`) with a **Gradio** UI. Unleash photorealistic videos with ≥6GB VRAM GPUs, optimized for 8GB RAM laptops.
----
-## 2 · Features
-- **Veo 3-Level AI**: Hyper-realistic video with next-frame prediction, smooth transitions.
-- **Phantom Speed**: Teacache cuts rendering time ~40% (~12-15s/frame on RTX 3060).
 - **Laptop Domination**: Supports 13B models on ≥6GB VRAM GPUs (e.g., RTX 3060).
-- **Custom Workflows**: Adjustable frame length, batch size, prompts.
-- **Live Preview**: Real-time frame previews in ghostgradio.py.
-- **Open Source**: Community-driven enhancements under Apache 2.0.
----
-## 3 · Optimizations
 - **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, \( T_{\text{sched}} \approx 0.8 \cdot T_{\text{base_sched}} \)).
 - **Memory**: Context Packing (~50% VRAM save, \( M_{\text{VRAM}} \propto O(1) \)), tcmalloc (~5-20% overhead, \( 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}} \)).
 - **Compute**: Dynamic Batching (~30-50% throughput, \( \text{Throughput} \propto B \cdot \text{FPS}_{\text{base}} \)).
 - **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}} \)).
-- **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).
----
-## 4 · Demo
-Witness GhostPack’s spectral video generation with a neon-lit spectral battle scene sample. [More Demos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos).
----
-## 5 · Future
 - **Voice Generation**: AI-driven voice synthesis for narrated videos.
 - **AI Images**: High-quality starting frames with AI visuals.
-- **VR Integration**: Future VR video rendering support.
----
-## 6 · Installation & How-To
-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 image, 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 CRF 0-100. Latest Release: [Link](https://github.com/ghostai1/GhostPack/releases).
----
-## 7 · Community
-Discord: [Join Now](https://discord.gg/ghostpack) for support. X: [Visit X](https://x.com/search?q=ghostpack) for news. Report Issues: [Link](https://github.com/ghostai1/GhostPack/issues).
----
-## 8 · Technical Deep Dive
-Architecture: Built on HunyuanVideo and FramePackI2V_HY with LlamaModel and CLIPTextModel. Pipeline: k-diffusion with unipc for high-quality frame generation. Wiki: [Link](https://github.com/ghostai1/GhostPack/wiki).
----
-## 9 · FAQ
-Hardware: Minimum 6GB VRAM (GTX 1650), 8GB RAM; Optimal 12GB VRAM (RTX 3060). Install: Clone and run appropriate install script (e.g., ./install_ubuntu.sh). Contribute: Yes, see Contributing Guidelines.
----
-## 10 · Tutorials
-Getting Started: [View](https://github.com/ghostai1/GhostPack/wiki/Getting-Started). Advanced Configuration: [View](https://github.com/ghostai1/GhostPack/wiki/Advanced-Configuration). Video Export Tips: [View](https://github.com/ghostai1/GhostPack/wiki/Video-Export-Tips). More Tutorials: [Link](https://github.com/ghostai1/GhostPack/wiki/Tutorials).
----
-## 11 · Contribute
-Fork repo, create branch, submit PRs, follow wiki standards, test with ghostgradio.py. Guidelines: [Link](https://github.com/ghostai1/GhostPack/blob/main/CONTRIBUTING.md).
----
-## 12 · Screenshots
 - **Main Interface**:
   <p align="center">
     <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/7ABE2lOA4LOUtPfh1mhxP.png" alt="Main Interface" style="max-width:100%; height:auto;">
@@ -95,17 +73,15 @@ Fork repo, create branch, submit PRs, follow wiki standards, test with ghostgrad
   <p align="center">
     <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/--fIS9ITg4-VqN22ySoa2.png" alt="Logs Display" style="max-width:100%; height:auto;">
   </p>
-Add your own to showcase projects!
----
-## 13 · Latest Files
-Latest File: [ghostgradio.py](https://github.com/ghostai1/GhostPack/blob/main/ghostgradio.py). Logs: [View](https://github.com/ghostai1/GhostPack/tree/main/outputs). Refresh Repo: [Link](https://github.com/ghostai1/GhostPack) | Refresh Logs: [Link](https://github.com/ghostai1/GhostPack/tree/main/outputs).
----
-## 14 · License
-Distributed under Apache 2.0. See [LICENSE](LICENSE) for details.
 👻 GhostPack by ghostai1 | [GitHub](https://github.com/ghostai1/GhostPack) | [Hugging Face](https://huggingface.co/spaces/ghostai1/GhostPack)
-Created 07:19 PM CDT, June 11, 2025 😈⚡️

 # 👻🎬 GhostPackDemo · Apache-2.0
+Generate cinematic **30 FPS** AI videos from a single image—runs locally on your GPU with ease.
 [![Python](https://img.shields.io/badge/python-3.8%2B-blue?logo=python)](https://python.org)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green)](LICENSE)
+[![HF Space](https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange)](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
 ---
+## Overview
+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.
+## Features
+- **Veo 3-Level AI**: Delivers hyper-realistic videos with next-frame prediction and smooth transitions.
+- **Phantom Speed**: Teacache reduces rendering time by ~40% (~12-15s/frame on RTX 3060).
 - **Laptop Domination**: Supports 13B models on ≥6GB VRAM GPUs (e.g., RTX 3060).
+- **Custom Workflows**: Adjust frame length, batch size, and prompts to suit your creativity.
+- **Live Preview**: View real-time frame previews in ghostgradio.py.
+- **Open Source**: Enhanced by community contributions under Apache 2.0.
+## Optimizations
 - **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, \( T_{\text{sched}} \approx 0.8 \cdot T_{\text{base_sched}} \)).
 - **Memory**: Context Packing (~50% VRAM save, \( M_{\text{VRAM}} \propto O(1) \)), tcmalloc (~5-20% overhead, \( 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}} \)).
 - **Compute**: Dynamic Batching (~30-50% throughput, \( \text{Throughput} \propto B \cdot \text{FPS}_{\text{base}} \)).
 - **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}} \)).
+- **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).
+## Demo
+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).
+## Future
 - **Voice Generation**: AI-driven voice synthesis for narrated videos.
 - **AI Images**: High-quality starting frames with AI visuals.
+- **VR Integration**: Future support for VR video rendering.
+## Installation & How-To
+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).
+## Community
+- **Discord**: [Join Now](https://discord.gg/ghostpack) for support.
+- **X**: [Visit X](https://x.com/search?q=ghostpack) for news.
+- **Report Issues**: [Link](https://github.com/ghostai1/GhostPack/issues).
+## Technical Deep Dive
+- **Architecture**: Built on HunyuanVideo and FramePackI2V_HY with LlamaModel and CLIPTextModel.
+- **Pipeline**: Uses k-diffusion with unipc for high-quality frame generation.
+- **Wiki**: [Link](https://github.com/ghostai1/GhostPack/wiki).
+## FAQ
+- **Hardware**: Minimum 6GB VRAM (GTX 1650), 8GB RAM; Optimal 12GB VRAM (RTX 3060).
+- **Install**: Clone and run the appropriate install script (e.g., ./install_ubuntu.sh).
+- **Contribute**: Yes, see Contributing Guidelines.
+## Tutorials
+- **Getting Started**: [View](https://github.com/ghostai1/GhostPack/wiki/Getting-Started).
+- **Advanced Configuration**: [View](https://github.com/ghostai1/GhostPack/wiki/Advanced-Configuration).
+- **Video Export Tips**: [View](https://github.com/ghostai1/GhostPack/wiki/Video-Export-Tips).
+- **More Tutorials**: [Link](https://github.com/ghostai1/GhostPack/wiki/Tutorials).
+## Contribute
+- Fork the repository, create a branch, submit pull requests, follow wiki standards, and test with ghostgradio.py.
+- **Guidelines**: [Link](https://github.com/ghostai1/GhostPack/blob/main/CONTRIBUTING.md).
+## Screenshots
 - **Main Interface**:
   <p align="center">
     <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/7ABE2lOA4LOUtPfh1mhxP.png" alt="Main Interface" style="max-width:100%; height:auto;">
   <p align="center">
     <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/--fIS9ITg4-VqN22ySoa2.png" alt="Logs Display" style="max-width:100%; height:auto;">
   </p>
+Add your own to showcase projects!
+## Latest Files
+- **Latest File**: [ghostgradio.py](https://github.com/ghostai1/GhostPack/blob/main/ghostgradio.py).
+- **Logs**: [View](https://github.com/ghostai1/GhostPack/tree/main/outputs).
+- **Refresh Repo**: [Link](https://github.com/ghostai1/GhostPack) | **Refresh Logs**: [Link](https://github.com/ghostai1/GhostPack/tree/main/outputs).
+## License
+Distributed under Apache 2.0. See [LICENSE](LICENSE) for details.
 👻 GhostPack by ghostai1 | [GitHub](https://github.com/ghostai1/GhostPack) | [Hugging Face](https://huggingface.co/spaces/ghostai1/GhostPack)
+Created 07:23 PM CDT, June 11, 2025 😈⚡️