GhostPackDemo/readme.md

👻 GhostPackDemo: Next-Gen AI Video Generator

Create real 30 FPS AI videos from a single image on your own GPU

---

🚀 What is GhostPackDemo?

GhostPackDemo is an open-source, GPU-optimized AI video generator. It fuses HunyuanVideo and FramePack into a single streamlined pipeline with a beautiful Gradio UI.

• Ultra Fast: Up to 40% faster thanks to Teacache, Sage-Attention, and dynamic batching.
• Resource-Smart: 50% lower VRAM (context packing, tcmalloc, memory cache).
• Laptop-Friendly: Works with 6GB VRAM, 8GB RAM (e.g., GTX 1650, RTX 3050/3060).
• No Cloud Needed: Run on your local desktop, server, or laptop.
• Full Control: Live preview, prompt/batch/frame/CRF settings, instant exports.

---

✨ Features

• Veo 3-Level AI: Next-frame video prediction for photorealistic motion.
• Phantom Speed: Teacache & Sage-Attention = 12–15s/frame (RTX 3060).
• Batch & Prompt Tuning: Full workflow control, see frames build in real time.
• Open Source: Apache 2.0, remix, extend, contribute.
• Export Quality: MP4 with customizable CRF (0–100).

---

🧙 Optimizations & Requirements

• Speed
  • Teacache: ~40% faster (T_total ≈ 0.6 × T_base)
  • Sage-Attention: +10%
  • CUDA tweaks: –15% latency
  • Dynamic scheduling: –20% time
• Memory
  • Context packing: –50% VRAM
  • tcmalloc: –20% overhead
  • Memory cache: –25% VRAM swap
• Compute
  • Dynamic batching: +50% throughput
• Efficiency
  • Power saving: –30% idle power
  • Thread tuning: +15% CPU
• 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

Minimum: NVIDIA GPU (6GB+ VRAM), 8GB RAM, 30GB free disk, Python 3.10+, CUDA 12.6+
Optimal: RTX 3060 or higher

---

📺 Demo & Screenshots

_{Main Interface   •   Advanced Settings   •   Logs}

See more: Demo Videos

---

🛠️ Installation

Ubuntu

git clone https://github.com/ghostai1/GhostPack
cd GhostPack
chmod +x install_ubuntu.sh
./install_ubuntu.sh

Windows

git clone https://github.com/ghostai1/GhostPack
cd GhostPack
install.bat

macOS

git clone https://github.com/ghostai1/GhostPack
cd GhostPack
chmod +x install_macos.sh
./install_macos.sh

---

🚦 Quick Start

source ~/ghostpack_venv/bin/activate
cd ~/ghostpack_venv
python ghostgradio.py --port 5666 --server 0.0.0.0

• Upload an image and enter your prompt
• Set FPS, batch size, video length, CRF, enable Teacache
• Watch your video build in real-time preview
• Export to MP4, any quality
• Monitor GPU usage: nvidia-smi

---

🌟 Roadmap

• AI Voice Generation: Narrate videos with custom voices
• AI Start Images: Generate ultra-high-res starting frames
• Native VR: Experimental 3D/VR video support

---

🤝 Community & Support

• Discord — Support & collabs
• GitHub Issues — Report bugs & request features
• Hugging Face Space — Live web demo

---

🧑‍💻 Contributing

• Fork, branch, PR. All improvements welcome!
• See CONTRIBUTING.md

---

📜 License

Apache 2.0
GhostPack by ghostai1 · Hugging Face
Created June 11, 2025