Add deployment guide and PowerShell script

DEPLOYMENT_GUIDE.md

@@ -0,0 +1,121 @@
+# 🚀 Manual Deployment Guide for Hugging Face Spaces
+
+Your OmniAvatar project has been prepared for deployment to Hugging Face Spaces. Since we encountered some authentication issues, here's how to complete the deployment manually:
+
+## 📋 Prerequisites
+
+1. **Hugging Face Account**: Make sure you have an account at https://huggingface.co/
+2. **Access Token**: Generate a write access token from https://huggingface.co/settings/tokens
+3. **Git**: Ensure Git is installed on your system
+
+## 🔑 Authentication Setup
+
+### Option 1: Using Hugging Face CLI (Recommended)
+```bash
+# Install the Hugging Face CLI
+pip install -U "huggingface_hub[cli]"
+
+# Login with your token
+huggingface-cli login
+
+# When prompted, enter your access token from https://huggingface.co/settings/tokens
+```
+
+### Option 2: Using Git Credentials
+```bash
+# Configure git to use your HF token as password
+git remote set-url origin https://bravedims:YOUR_HF_TOKEN@huggingface.co/spaces/bravedims/AI_Avatar_Chat.git
+```
+
+## 📤 Deploy to Hugging Face
+
+Once authenticated, push your changes:
+
+```bash
+# Navigate to the deployment directory
+cd path/to/HF_Deploy/AI_Avatar_Chat
+
+# Push to deploy
+git push origin main
+```
+
+## 📁 Files Prepared for Deployment
+
+Your space now includes:
+
+- ✅ **app.py** - Main application with FastAPI + Gradio interface
+- ✅ **requirements.txt** - Optimized dependencies for HF Spaces
+- ✅ **Dockerfile** - HF Spaces compatible Docker configuration
+- ✅ **README.md** - Comprehensive space documentation
+- ✅ **configs/** - Model configuration files
+- ✅ **scripts/** - Inference scripts
+- ✅ **examples/** - Sample inputs
+- ✅ **elevenlabs_integration.py** - TTS integration
+
+## 🔧 Space Configuration
+
+The space is configured with:
+
+- **SDK**: Docker
+- **Hardware**: T4-medium (GPU enabled)
+- **Port**: 7860 (required by HF Spaces)
+- **User**: Non-root user as required by HF
+- **Base Image**: PyTorch with CUDA support
+
+## 🎯 Key Features Deployed
+
+1. **🎭 Avatar Generation**: Text-to-avatar with lip-sync
+2. **🗣️ ElevenLabs TTS**: High-quality text-to-speech
+3. **🎵 Audio URL Support**: Direct audio file inputs
+4. **🖼️ Image References**: Guide avatar appearance
+5. **⚡ GPU Acceleration**: Optimized for HF hardware
+
+## 🛠️ Environment Variables
+
+To enable ElevenLabs TTS functionality:
+
+1. Go to your Space settings on HF
+2. Add a secret named `ELEVENLABS_API_KEY`
+3. Set the value to your ElevenLabs API key
+
+## 🎮 Testing Your Deployment
+
+After deployment:
+
+1. Wait for the space to build (may take 10-15 minutes)
+2. Access your space at: https://huggingface.co/spaces/bravedims/AI_Avatar_Chat
+3. Test the Gradio interface with sample prompts
+4. Verify API endpoints work: `/health`, `/generate`
+
+## 📊 Monitoring
+
+- Check build logs in the HF Space interface
+- Monitor resource usage and performance
+- Review user feedback and iterate
+
+## 🔄 Updating Your Space
+
+To make changes:
+
+1. Modify files in your local HF_Deploy/AI_Avatar_Chat directory
+2. Commit changes: `git add . && git commit -m "Update message"`
+3. Push: `git push origin main`
+4. HF will automatically rebuild and redeploy
+
+## 🆘 Troubleshooting
+
+- **Build fails**: Check Dockerfile and requirements.txt
+- **Model not found**: Ensure download_models.sh runs correctly
+- **Memory issues**: Consider upgrading to larger hardware
+- **Port conflicts**: Space must use port 7860
+
+---
+
+## 🎯 Next Steps
+
+1. Complete authentication setup above
+2. Push to deploy: `git push origin main`
+3. Configure ElevenLabs API key as secret
+4. Test and iterate on your deployed space!
+
+Your OmniAvatar-14B space is ready for deployment! 🚀

deploy.ps1

@@ -0,0 +1,35 @@
+# PowerShell deployment script for Windows
+# Run this script after setting up your HF token
+
+param(
+    [Parameter(Mandatory=$true)]
+    [string]$HF_TOKEN
+)
+
+Write-Host "🚀 Deploying OmniAvatar to Hugging Face Spaces..." -ForegroundColor Green
+
+# Set git remote with token authentication
+$gitPath = "C:\Program Files\Git\bin\git.exe"
+
+try {
+    Write-Host "📡 Configuring authentication..." -ForegroundColor Yellow
+    & $gitPath remote set-url origin "https://bravedims:$HF_TOKEN@huggingface.co/spaces/bravedims/AI_Avatar_Chat.git"
+    
+    Write-Host "📤 Pushing to Hugging Face..." -ForegroundColor Yellow
+    & $gitPath push origin main
+    
+    if ($LASTEXITCODE -eq 0) {
+        Write-Host "✅ Deployment successful!" -ForegroundColor Green
+        Write-Host "🌐 Your space will be available at: https://huggingface.co/spaces/bravedims/AI_Avatar_Chat" -ForegroundColor Cyan
+        Write-Host "⏱️  Build time: ~10-15 minutes" -ForegroundColor Yellow
+        Write-Host ""
+        Write-Host "🔑 Don't forget to add your ElevenLabs API key as a secret in the space settings!" -ForegroundColor Magenta
+    } else {
+        Write-Host "❌ Deployment failed. Check the error messages above." -ForegroundColor Red
+        exit 1
+    }
+}
+catch {
+    Write-Host "❌ Error during deployment: $($_.Exception.Message)" -ForegroundColor Red
+    exit 1
+}