Upload README.md with huggingface_hub

README.md

@@ -1,12 +1,60 @@
 ---
-title: IceBreaker Avator Generator
-emoji: 📚
+title: 🎭 IceBreaker Avatar Generator
+emoji: 🎭
 colorFrom: purple
-colorTo: green
+colorTo: blue
 sdk: gradio
 sdk_version: 5.34.2
 app_file: app.py
 pinned: false
+license: mit
+hardware: zerogpu
+short_description: Generate personalized avatars from Chinese portraits
+models:
+- black-forest-labs/FLUX.1-schnell
+- google/gemma-3n-E2B-it
+tags:
+- avatar
+- image-generation
+- flux
+- chinese-portrait
+- character-design
+- ai-art
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# 🎭 IceBreaker Avatar Generator
+
+Generate unique avatars based on Chinese portrait descriptions! This app combines the power of FLUX.1-schnell for image generation and Gemma-3n-E2B-it for conversational AI.
+
+## Features
+
+🎨 **Dual Generation Modes**:
+- **📝 Form Mode**: Direct input with customizable "If I was / I would be" groups
+- **💬 Chat Mode**: AI-guided conversation to discover your Chinese portrait
+
+⚡ **Quality Options**:
+- **Normal**: 512x512, 4 steps (fast)
+- **High**: 512x512, 8 steps (enhanced quality)
+
+🤖 **AI Models**:
+- **FLUX.1-schnell**: High-quality image generation
+- **Gemma-3n-E2B-it**: Fast and efficient conversation assistant
+
+## How to Use
+
+### Form Mode
+1. Complete at least the first 3 groups (mandatory)
+2. Add optional groups 4-5 for richer portraits
+3. Select quality and generate your avatar
+
+### Chat Mode
+1. Click "🚀 Start Conversation"
+2. Follow the AI assistant's guided questions
+3. Click "🎨 Get My Avatar" when ready
+
+## Example Chinese Portrait
+*If I was an animal, I would be a majestic wolf*
+*If I was a color, I would be deep purple*
+*If I was an object, I would be an ancient sword*
+
+Try it now and discover your unique avatar! ✨