Update GhostPackDemo/readme.md

GhostPackDemo/readme.md

@@ -1,6 +1,6 @@
-# 👻 GhostPackDemo: Next-Gen AI Video Generator
+# 👻🚧 GhostPackDemo (BETA) – Next-Gen AI Video Generator
 
-**Create real 30 FPS AI videos from a single image on your own GPU**  
+**Beta Demo — Try experimental AI video creation, directly 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)
 [![Live Demo](https://img.shields.io/badge/🤗%20Spaces-Live%20Demo-orange)](https://huggingface.co/spaces/ghostai1/GhostPackDemo)
@@ -11,58 +11,50 @@
 
 <img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/2RH49llUgKsmWY7Hu8yBD.gif"
      alt="GhostPack Animated Banner"
-     style="width: 920px; height: 260px; max-width: 100%; border-radius: 16px; box-shadow: 0 0 40px #00ffcc; margin-bottom: 32px; display: block;">
+     style="width: 920px; height: 260px; max-width: 100%; border-radius: 18px; box-shadow: 0 0 48px #00ffcc; margin-bottom: 36px; display: block;">
 
 </div>
 
 ---
 
-## 🚀 What is GhostPackDemo?
+## 🚀 What is GhostPackDemo? (Beta)
 
-**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.
+**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.
 
-- **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.
+- 🦾 **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
+## ✨ Features (Beta)
 
-- **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).
+- **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).
 
 ---
 
-## 🧙 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**
+## 🧙 Math Sorcery & Hardware
+
+- <span style="color:#00ffa2">**Speed:**</span> Teacache ~40% (`T_total ≈ 0.6 × T_base`), Sage-Attention +10%, CUDA tweaks –15% latency
+- <span style="color:#a200ff">**Memory:**</span> Context packing –50% VRAM, tcmalloc –20% overhead, memory cache –25%
+- <span style="color:#00c3ff">**Compute:**</span> Dynamic batching +50% throughput
+- <span style="color:#ffff00">**Efficiency:**</span> Power save –30% idle, Thread tuning +15% CPU
+- <span style="color:#ff5e57">**VRAM Needs:**</span>
   - 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
+**Minimum:** NVIDIA GPU (6GB+), 8GB RAM, 30GB+ disk, Python 3.10+, CUDA 12.6+  
+**Recommended:** RTX 3060 or better
 
 ---
 
@@ -70,7 +62,7 @@
 
 <div align="center">
 
-<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/k8pgUlg4OvdUZpbMNTcp5.gif" alt="GhostPack Demo GIF" style="width: 470px; height: auto; border-radius: 16px; box-shadow: 0 0 32px #ff00ff; margin-bottom: 28px;">
+<img src="https://cdn-uploads.huggingface.co/production/uploads/6421b1c68adc8881b974a89d/k8pgUlg4OvdUZpbMNTcp5.gif" alt="GhostPack Demo GIF" style="width: 470px; height: auto; border-radius: 18px; box-shadow: 0 0 32px #ff00ff; margin-bottom: 28px;">
 
 <div style="display: flex; flex-direction: row; justify-content: center; gap: 28px;">
 
@@ -88,11 +80,13 @@
 
 </div>
 
-> See more: [Demo Videos](https://github.com/ghostai1/GhostPack/blob/main/demo_videos)
+> 🎬 [More Demo Clips](https://github.com/ghostai1/GhostPack/blob/main/demo_videos)
 
 ---
 
-## 🛠️ Installation
+## ⚙️ Installation (Beta)
+
+> 💾 *30GB+ free space needed. Installs models on first run.*
 
 **Ubuntu**
 ```bash
@@ -119,46 +113,50 @@ chmod +x install_macos.sh
 
 ---
 
-## 🚦 Quick Start
+## ⚡ Quick Start
 
 ```bash
 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`
+- 🖼️ 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
+## 🗺️ 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  
+- 🗣️ **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 & Support
+## 💬 Community & Help
 
-- [Discord](https://discord.gg/ghostpack) — Support & collabs
-- [GitHub Issues](https://github.com/ghostai1/GhostPack/issues) — Report bugs & request features
-- [Hugging Face Space](https://huggingface.co/spaces/ghostai1/GhostPackDemo) — Live web demo
+- [Discord](https://discord.gg/ghostpack) – Feedback & support  
+- [GitHub Issues](https://github.com/ghostai1/GhostPack/issues) – Bugs & requests  
+- [Hugging Face Space](https://huggingface.co/spaces/ghostai1/GhostPackDemo) – Try the live demo
 
 ---
 
-## 🧑‍💻 Contributing
+## 👨‍💻 Contributing
 
-- Fork, branch, PR. All improvements welcome!
+- Fork, branch, and PR! Beta testers wanted!
 - See [CONTRIBUTING.md](https://github.com/ghostai1/GhostPack/blob/main/CONTRIBUTING.md)
 
 ---
 
-## 📜 License
+## 🪪 License
 
 Apache 2.0  
 **GhostPack by [ghostai1](https://github.com/ghostai1/GhostPack) · [Hugging Face](https://huggingface.co/ghostai1)**  
-*Created June 11, 2025*
+*BETA build · Created June 11, 2025*
+
+---