Improve README with tags, description, and features for discoverability

README.md

@@ -1,5 +1,5 @@
 ---
-title: Z Image Turbo
+title: Z-Image Generation & Transformation Demo
 emoji: ⚡
 colorFrom: blue
 colorTo: indigo
@@ -7,6 +7,78 @@ sdk: gradio
 sdk_version: 5.31.0
 app_file: app.py
 pinned: true
+license: apache-2.0
+tags:
+  - text-to-image
+  - image-to-image
+  - diffusion
+  - transformer
+  - z-image
+  - ai-art
+  - image-generation
+  - image-editing
+short_description: Generate & transform images with Z-Image-Turbo AI model
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# ⚡ Z-Image Generation & Transformation Demo
+
+Generate stunning AI images and transform existing photos using **Alibaba's Z-Image-Turbo** - a next-generation diffusion transformer model.
+
+## ✨ Features
+
+🎨 **Text-to-Image Generation**
+- 10 style presets (Photorealistic, Cinematic, Anime, Digital Art, and more)
+- 18 aspect ratios from 1024px to 2048px
+- AI-powered prompt polishing with Qwen2.5-72B
+
+🖼️ **Image-to-Image Transformation**
+- Transform photos into different art styles
+- Adjustable strength control (subtle to complete change)
+- Style-focused AI prompt enhancement
+
+⚡ **Optimized Performance**
+- Runs on ZeroGPU (NVIDIA H200)
+- FlashAttention-2 via SDPA
+- ~20-25 seconds per generation
+
+## 🚀 How to Use
+
+### Generate Tab
+1. Enter a description of your image
+2. (Optional) Enable "Polish Prompt" for AI-enhanced prompts
+3. Select a style and aspect ratio
+4. Click "Generate"
+
+### Transform Tab
+1. Upload an image
+2. Describe the transformation you want
+3. Adjust strength (lower = subtle, higher = dramatic)
+4. Click "Transform"
+
+## 🎯 Example Prompts
+
+- *"Ancient dragon perched on a Gothic cathedral at dusk, stormy purple sky"*
+- *"Cyberpunk samurai in a neon-lit rainy alley, glowing armor"*
+- *"Cozy witch cottage interior, cauldrons bubbling, magical atmosphere"*
+
+## 📊 Technical Details
+
+| Spec | Value |
+|------|-------|
+| Model | Tongyi-MAI/Z-Image-Turbo |
+| Steps | 9 (optimized) |
+| Precision | BFloat16 |
+| Max Resolution | 2048x2048 |
+
+## 🔗 Links
+
+- [Z-Image-Turbo Model](https://huggingface.co/Tongyi-MAI/Z-Image-Turbo)
+- [Z-Image GitHub](https://github.com/Tongyi-MAI/Z-Image)
+
+## 📜 License
+
+Model: Apache 2.0 License
+
+---
+
+**Created by [@lulavc](https://huggingface.co/lulavc)**