ghostai1's picture
Update GhostPackDemo/readme.md
e76a344 verified

πŸ‘»πŸš§ GhostPackDemo (BETA) – Next-Gen AI Video Generator

Beta Demo β€” Try experimental AI video creation, directly on your GPU!
Python License Live Demo


GhostPack Animated Banner


πŸš€ What is GhostPackDemo? (Beta)

GhostPackDemo is an open-source AI video generator for your local GPU. This BETA combines HunyuanVideo and FramePack into a single Python pipeline + live Gradio UI.

  • 🦾 Fast: 40% faster with Teacache, Sage-Attention, CUDA tweaks.
  • 🧠 Efficient: 50% less VRAM (context packing, tcmalloc, memory cache).
  • πŸ’» Laptop-Ready: 6GB VRAM & 8GB RAM minimum (GTX 1650/RTX 3050+).
  • πŸ”’ Runs Local: All processing on your own hardware β€” no cloud!
  • πŸŽ›οΈ Live Preview: See every frame build in real time, full workflow control.

Beta Notice: Expect rough edges, limited samplers, and edge-case bugs! This demo build prioritizes clarity and reproducibility for AI devs.


✨ Features (Beta)

  • Veo 3-Level AI: Next-frame prediction for ultra-realistic video motion.
  • Phantom Speed: Teacache + Sage-Attention, 12–15s/frame (RTX 3060).
  • Config Control: Batch size, frame window, prompt, CRF, see everything live.
  • Open Source: Apache 2.0 β€” fork, remix, contribute!
  • Export: High quality MP4 (CRF 0–100).

πŸ§™ Math Sorcery & Hardware

  • Speed: Teacache ~40% (T_total β‰ˆ 0.6 Γ— T_base), Sage-Attention +10%, CUDA tweaks –15% latency
  • Memory: Context packing –50% VRAM, tcmalloc –20% overhead, memory cache –25%
  • Compute: Dynamic batching +50% throughput
  • Efficiency: Power save –30% idle, 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+), 8GB RAM, 30GB+ disk, Python 3.10+, CUDA 12.6+
Recommended: RTX 3060 or better


πŸ“‘ .env Setup (IMPORTANT)

You must add your Hugging Face token to .env to download models and samplers!

Create a file called .env in the project root with:

HF_TOKEN=hf_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

πŸ“Ί Demo & Screenshots

GhostPack Demo GIF
Main Interface Advanced Settings Logs Display
Main Interface   β€’   Advanced Settings   β€’   Logs

🎬 More Demo Clips


βš™οΈ Installation (Beta)

πŸ’Ύ 30GB+ free space needed. Installs models on first run.

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
  • πŸ’¬ Enter a prompt (e.g. β€œA graceful dance movement”)
  • πŸ”„ Enable Teacache, set video seconds, steps, CRF
  • πŸ‘€ See live frame preview + logs
  • πŸ’Ύ Export MP4 instantly
  • πŸ–₯️ Monitor GPU: nvidia-smi

πŸ—ΊοΈ Roadmap

  • πŸ—£οΈ AI Voice: Add local voiceover/narration
  • πŸ–ΌοΈ AI Start Images: Next-level starting frames
  • πŸ•ΆοΈ VR Support: Immersive AI video output
  • πŸ”’ More Samplers/Models coming soon

πŸ’¬ Community & Help


πŸ‘¨β€πŸ’» Contributing


πŸͺͺ License

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