Create README.md

README.md

@@ -1,12 +1,39 @@
 ---
-title: Image To Image
-emoji: 🐨
-colorFrom: indigo
-colorTo: red
+title: Talking Character Generator
 sdk: gradio
-sdk_version: 5.35.0
-app_file: app.py
-pinned: false
+emoji: 🚀
+colorFrom: blue
+colorTo: purple
+short_description: 'Generate talking character videos with mouth movements from '
 ---
+# 🎭 Talking Character Generator
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+A Hugging Face Gradio application that generates talking character videos with mouth movements based on input text.
+
+## Features
+
+- **Text-to-Speech Generation**: Uses Microsoft's SpeechT5 model for high-quality speech synthesis
+- **3 Character Options**: Choose from Friendly Robot, Cartoon Person, or Cute Animal
+- **Mouth Animation**: Generates realistic mouth movements synchronized with speech
+- **Video Output**: Creates MP4 videos of characters speaking your text
+- **Easy Web Interface**: Simple Gradio interface for easy interaction
+
+## Usage
+
+1. Enter your text in the input box
+2. Select a character from the dropdown menu
+3. Click "Generate Talking Character" to create your video
+
+## How It Works
+
+1. **Text Processing**: The input text is analyzed for syllables and word structure
+2. **Speech Generation**: Uses the SpeechT5 TTS model to generate high-quality speech audio
+3. **Character Selection**: Loads the selected character image (SVG format)
+4. **Animation Creation**: Generates mouth movements based on the speech timing and text analysis
+5. **Video Compilation**: Combines the character animation frames into an MP4 video
+
+## Character Options
+
+1. **Friendly Robot**: A blue robotic character with a friendly appearance
+2. **Cartoon Person**: A human-like cartoon character with warm colors
+3. **Cute Animal**: An adorable animal character with big eyes