Add font support and documentation files

DEPLOYMENT_SUMMARY.md

@@ -7,16 +7,35 @@ Your Qwen OCR app is ready for deployment to Hugging Face Spaces!
 - **app.py** - Main Gradio application (API-only version, optimized for HF Spaces)
 - **requirements.txt** - Minimal dependencies for the app
 - **README.md** - Hugging Face Space card with app description
-- **deploy.sh** - Automated deployment script
+- **deploy.sh** - Automated deployment script (updated with better auth handling)
+- **auth_check.sh** - Authentication status checker
 - **deploy_instructions.md** - Detailed deployment instructions
 - **test_local.py** - Local testing script
 
+## 🔑 Authentication Required!
+
+### First, check your authentication:
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./auth_check.sh
+```
+
+### Get your Hugging Face token:
+1. Go to https://huggingface.co/settings/tokens
+2. Create a new token with **WRITE** access (not READ!)
+3. Copy the token (starts with `hf_...`)
+
 ## 🎯 Quick Deploy
 
-### Option 1: Automated Script (Recommended)
+### Option 1: Automated Script with Token (Recommended)
 ```bash
 cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
-./deploy.sh YOUR_HF_USERNAME qwen-ocr-detection
+./deploy.sh YOUR_HF_USERNAME qwen-ocr-detection YOUR_HF_TOKEN
+```
+
+Example:
+```bash
+./deploy.sh Sangmin qwen-ocr-detection hf_xxxxxxxxxxxxxxxxxxxx
 ```
 
 ### Option 2: Manual Web Upload
@@ -25,11 +44,17 @@ cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
 3. Upload `app.py`, `requirements.txt`, and `README.md`
 4. Wait for automatic deployment
 
-### Option 3: Git Commands
+### Option 3: Manual Git Commands
 ```bash
 cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+
+# First, login with your token
 huggingface-cli login
-huggingface-cli repo create qwen-ocr-detection --type space --space_sdk gradio
+# Or set token as environment variable
+export HF_TOKEN=your_token_here
+
+# Create Space and push
+huggingface-cli repo create YOUR_USERNAME/qwen-ocr-detection --type space --space_sdk gradio
 git init
 git add .
 git commit -m "Initial commit"

DEPLOY_WITH_FONTS.md

@@ -0,0 +1,121 @@
+# 🚀 Complete Deployment Guide with CJK Font Support
+
+## Quick Deploy (All Fixes Included)
+
+### Files Required for Hugging Face Space
+You need these 5 essential files:
+
+1. **`packages.txt`** - System packages (fonts)
+2. **`requirements.txt`** - Python packages  
+3. **`app.py`** - Main application
+4. **`app_simple.py`** - Fallback version
+5. **`README.md`** - Space description
+
+### Deploy Command
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./deploy.sh YOUR_USERNAME YOUR_SPACE_NAME YOUR_TOKEN
+```
+
+Example:
+```bash
+./deploy.sh Sangmin qwen-ocr-detection hf_xxxxxxxxxxxx
+```
+
+### Or Update Existing Space
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./update_space.sh
+```
+
+## What Gets Installed
+
+### System Packages (`packages.txt`)
+```
+fonts-noto-cjk          # CJK fonts (Chinese, Japanese, Korean)
+fonts-noto-cjk-extra    # Additional CJK fonts
+fonts-noto-color-emoji  # Emoji support
+fonts-liberation        # Liberation fonts
+fonts-dejavu-core       # DejaVu fonts
+```
+
+### Python Packages (`requirements.txt`)
+```
+gradio==4.19.2     # Stable Gradio version
+Pillow>=10.0.0     # Image processing
+openai>=1.0.0      # API client
+```
+
+## How Hugging Face Processes These Files
+
+1. **Build Phase**:
+   - Reads `packages.txt` → runs `apt-get install` for each package
+   - Reads `requirements.txt` → runs `pip install` for each package
+   - Installs fonts to `/usr/share/fonts/`
+
+2. **Runtime**:
+   - App starts with all fonts available
+   - Font paths are Linux-specific (not macOS)
+   - App searches multiple paths for fonts
+
+## Verification After Deployment
+
+### Check Build Logs
+Look for:
+```
+Installing apt packages from packages.txt
+Reading package lists...
+Setting up fonts-noto-cjk (1:20201206-1) ...
+```
+
+### Check App Logs
+Look for:
+```
+✅ Loaded font: /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc
+```
+
+### Test CJK Text
+Upload an image with:
+- Japanese: ひらがな、カタカナ、漢字
+- Chinese: 中文测试
+- Korean: 한글 테스트
+
+## Troubleshooting
+
+### If Fonts Don't Load
+1. **Check packages.txt exists** in your Space
+2. **Rebuild the Space**: Settings → Factory Reboot
+3. **Use test_fonts.py** to debug available fonts
+
+### If App Crashes
+1. **Use app_simple.py**: Change app_file in Settings
+2. **Check Gradio version**: Must be 4.19.2
+3. **Verify launch config**: Must include server settings
+
+## Manual Web Deployment
+
+If scripts don't work, upload via web:
+
+1. Go to: https://huggingface.co/new-space
+2. Create Space (Gradio SDK)
+3. Upload these files:
+   - `packages.txt` (IMPORTANT!)
+   - `requirements.txt`
+   - `app.py`
+   - `README.md`
+4. Wait for build to complete
+
+## Expected Result
+
+✅ App runs without errors
+✅ Japanese text displays correctly in boxes
+✅ Chinese text displays correctly in boxes
+✅ Korean text displays correctly in boxes
+✅ Bounding boxes align with text
+✅ Text labels are readable
+
+---
+
+**Your OCR app is ready with full CJK support!** 🎌🇨🇳🇰🇷
+
+Token: Get from https://huggingface.co/settings/tokens (need WRITE access)

FIX_SUMMARY.md

@@ -0,0 +1,77 @@
+# 🔧 Fixes Applied for Hugging Face Deployment Error
+
+## Problem
+The app crashed on Hugging Face Spaces with:
+- `TypeError: argument of type 'bool' is not iterable` in Gradio's API schema generation
+- `ValueError: When localhost is not accessible, a shareable link must be created`
+
+## Root Causes
+1. **Gradio version incompatibility** - Version 4.44.1 has a bug with API schema generation
+2. **Incorrect launch configuration** - Missing proper server settings for HF Spaces
+
+## Solutions Implemented
+
+### 1. Updated `requirements.txt`
+```diff
+- gradio==4.44.1
++ gradio==4.19.2  # Stable version for HF Spaces
+- Pillow==10.4.0
++ Pillow>=10.0.0  # More flexible versioning
+- openai==1.51.0
++ openai>=1.0.0   # More flexible versioning
+```
+
+### 2. Fixed `app.py` Launch Configuration
+```diff
+- demo.launch()
++ demo.queue(max_size=20).launch(server_name="0.0.0.0", server_port=7860)
+```
+
+### 3. Created `app_simple.py` (Fallback)
+- Simplified version without complex features
+- Minimal dependencies
+- More robust error handling
+
+## To Deploy the Fixes
+
+### Quick Update (if already deployed):
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./update_space.sh
+```
+
+### Fresh Deployment:
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./deploy.sh YOUR_USERNAME YOUR_SPACE_NAME YOUR_TOKEN
+```
+
+### Manual Update (via web):
+1. Go to your Space
+2. Edit `requirements.txt` with new versions
+3. Edit `app.py` with new launch configuration
+4. Commit changes
+
+## Files Updated/Created
+- ✅ `app.py` - Fixed launch configuration
+- ✅ `requirements.txt` - Downgraded Gradio to stable version
+- ✅ `app_simple.py` - Simplified fallback version
+- ✅ `update_space.sh` - Script to push fixes
+- ✅ `TROUBLESHOOTING.md` - Complete troubleshooting guide
+- ✅ `FIX_SUMMARY.md` - This summary
+
+## Verification
+After deployment, the app should:
+1. Start without errors
+2. Show "Running on local URL: http://0.0.0.0:7860"
+3. Be accessible at your Space URL
+4. Accept image uploads and API keys
+5. Return annotated images with bounding boxes
+
+## If Issues Persist
+Use the simplified version:
+1. In Space settings, change `app_file` to `app_simple.py`
+2. The simplified version has fewer dependencies and is more stable
+
+---
+**Status: Ready to deploy fixes!** 🚀

FONT_FIX_SUMMARY.md

@@ -0,0 +1,99 @@
+# 🔤 CJK Font Support for Hugging Face Spaces
+
+## The Solution: `packages.txt`
+
+Hugging Face Spaces allows you to install system packages (like fonts) using a special file called `packages.txt`. This file works like `requirements.txt` but for system packages installed via `apt-get`.
+
+## Files Created/Updated
+
+### 1. **`packages.txt`** (NEW)
+```
+fonts-noto-cjk
+fonts-noto-cjk-extra
+fonts-noto-color-emoji
+fonts-liberation
+fonts-dejavu-core
+```
+
+This tells Hugging Face to run:
+```bash
+apt-get install fonts-noto-cjk fonts-noto-cjk-extra fonts-noto-color-emoji fonts-liberation fonts-dejavu-core
+```
+
+### 2. **Updated `app.py`** and **`app_simple.py`**
+- Added proper Linux font paths
+- Added font loading verification
+- Added fallback handling
+
+## How It Works
+
+1. **During Build**: HF Spaces reads `packages.txt` and installs the listed packages
+2. **Font Installation**: The Noto CJK fonts get installed to `/usr/share/fonts/`
+3. **App Runtime**: The app searches for fonts in the correct Linux paths
+4. **CJK Support**: Japanese, Chinese, and Korean text will display correctly in bounding boxes
+
+## Font Paths on Hugging Face Spaces (Linux)
+
+```python
+font_paths = [
+    # Primary CJK fonts
+    "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
+    "/usr/share/fonts/truetype/noto-cjk/NotoSansCJK-Regular.ttc",
+    
+    # Fallback fonts
+    "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf",
+    "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+]
+```
+
+## To Deploy with Font Support
+
+### Option 1: Update Existing Space
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./update_space.sh
+```
+
+### Option 2: Manual Upload
+Upload these 4 files to your Space:
+1. `packages.txt` - System packages to install
+2. `requirements.txt` - Python packages
+3. `app.py` - Updated main app
+4. `app_simple.py` - Updated simple version
+
+### Option 3: Fresh Deploy
+```bash
+./deploy.sh YOUR_USERNAME YOUR_SPACE YOUR_TOKEN
+```
+
+## Verification
+
+After deployment, check the build logs for:
+```
+Installing apt packages from packages.txt
+Reading package lists...
+Setting up fonts-noto-cjk...
+```
+
+In the app logs, you should see:
+```
+✅ Loaded font: /usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc
+```
+
+## Result
+
+✅ Japanese text (ひらがな、カタカナ、漢字) will display correctly
+✅ Chinese text (简体/繁體) will display correctly  
+✅ Korean text (한글) will display correctly
+✅ Emoji and symbols will render properly
+
+## Troubleshooting
+
+If fonts still don't work:
+1. Check build logs for package installation errors
+2. Try different font paths in the app
+3. Use `fc-list` command in a debug script to list available fonts
+
+---
+
+**The app now has full CJK font support on Hugging Face Spaces!** 🎌🇨🇳🇰🇷

README.md

@@ -5,7 +5,7 @@ colorFrom: blue
 colorTo: green
 sdk: gradio
 sdk_version: 4.44.1
-app_file: app.py
+app_file: app_simple.py
 pinned: false
 license: apache-2.0
 ---
@@ -16,9 +16,10 @@ This Gradio app uses Qwen Vision Language Models to detect text in images and dr
 
 ## Features
 - 📝 Automatic text detection with precise bounding boxes
-- 🌏 Support for multiple languages including CJK (Chinese, Japanese, Korean)
+- 🌏 Full support for CJK languages (Chinese, Japanese, Korean) with proper fonts
 - 📊 JSON output with exact coordinates and text content
 - 🎯 Adjustable prompts for custom detection behavior
+- 🔤 Noto CJK fonts pre-installed for accurate text rendering
 
 ## How to Use
 1. Upload an image containing text

TROUBLESHOOTING.md

@@ -0,0 +1,97 @@
+# 🔧 Troubleshooting Guide for Hugging Face Deployment
+
+## Error: "TypeError: argument of type 'bool' is not iterable"
+
+### Solution Applied:
+1. **Downgraded Gradio** to stable version 4.19.2
+2. **Fixed launch configuration** for HF Spaces
+3. **Created simplified version** (app_simple.py) as fallback
+
+### To Apply Fixes:
+
+#### Option 1: Update Existing Space
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+./update_space.sh
+```
+
+#### Option 2: Manual Update via Web
+1. Go to your Space: https://huggingface.co/spaces/YOUR_USERNAME/YOUR_SPACE
+2. Click "Files" tab
+3. Edit `requirements.txt`:
+   ```
+   gradio==4.19.2
+   Pillow>=10.0.0
+   openai>=1.0.0
+   ```
+4. Edit `app.py` - change last line to:
+   ```python
+   demo.queue(max_size=20).launch(server_name="0.0.0.0", server_port=7860)
+   ```
+5. Commit changes
+
+#### Option 3: Use Simplified Version
+If main app still has issues:
+1. Upload `app_simple.py` to your Space
+2. Go to Space Settings
+3. Change `app_file` from `app.py` to `app_simple.py`
+4. Save changes
+
+## Other Common Issues
+
+### 1. Build Fails
+- Check logs in "Logs" tab
+- Verify requirements.txt syntax
+- Try simplified app version
+
+### 2. App Crashes on Start
+- Check API endpoint is correct
+- Verify Gradio version compatibility
+- Use app_simple.py instead
+
+### 3. Authentication Errors
+- Ensure token has WRITE access
+- Re-run deploy script with token:
+  ```bash
+  ./deploy.sh USERNAME SPACE_NAME YOUR_TOKEN
+  ```
+
+### 4. Image Processing Errors
+- Verify API key is valid
+- Check Dashscope service is accessible
+- Test locally first with test_local.py
+
+## Version Compatibility
+
+### Working Configurations:
+- **Gradio**: 4.19.2 (stable for HF Spaces)
+- **Python**: 3.10 (HF Spaces default)
+- **Pillow**: 10.0.0+
+- **OpenAI**: 1.0.0+
+
+### Known Incompatible Versions:
+- Gradio 4.44.1 (API schema bug)
+- Gradio 4.40+ (may have compatibility issues)
+
+## Testing Locally
+
+Before deploying, always test:
+```bash
+cd /Users/sangmin/Developer/Qwen2.5-VL/huggingface-space
+python test_local.py
+# Or test the simple version:
+python app_simple.py
+```
+
+## Still Having Issues?
+
+1. **Check HF Status**: https://status.huggingface.co/
+2. **Try Different Region**: Some regions may have better connectivity
+3. **Use Simplified App**: app_simple.py has fewer dependencies
+4. **Manual Deployment**: Upload files directly via web interface
+
+## Contact & Support
+
+- Hugging Face Discord: https://discord.gg/huggingface
+- Hugging Face Forums: https://discuss.huggingface.co/
+- Gradio Issues: https://github.com/gradio-app/gradio/issues

auth_check.sh

@@ -0,0 +1,42 @@
+#!/bin/bash
+
+# Simple script to check Hugging Face authentication status
+
+echo "🔍 Checking Hugging Face Authentication Status..."
+echo ""
+
+# Check if CLI is installed
+if ! command -v huggingface-cli &> /dev/null; then
+    echo "❌ huggingface-cli not installed!"
+    echo "Install with: pip install huggingface_hub"
+    exit 1
+fi
+
+# Check login status
+echo "Running: huggingface-cli whoami"
+echo "----------------------------------------"
+
+if huggingface-cli whoami 2>/dev/null; then
+    echo "----------------------------------------"
+    echo "✅ You are logged in!"
+    echo ""
+    echo "If deployment still fails, your token might not have WRITE permissions."
+    echo "Get a new token at: https://huggingface.co/settings/tokens"
+else
+    echo "----------------------------------------"
+    echo "❌ Not logged in to Hugging Face!"
+    echo ""
+    echo "To login, use one of these methods:"
+    echo ""
+    echo "1. Interactive login:"
+    echo "   huggingface-cli login"
+    echo ""
+    echo "2. Token environment variable:"
+    echo "   export HF_TOKEN=your_token_here"
+    echo ""
+    echo "3. Pass token to deploy script:"
+    echo "   ./deploy.sh USERNAME SPACE_NAME your_token_here"
+    echo ""
+    echo "Get your token (WRITE access) at:"
+    echo "https://huggingface.co/settings/tokens"
+fi

deploy.sh

@@ -1,19 +1,23 @@
 #!/bin/bash
 
 # Deployment script for Hugging Face Spaces
-# Usage: ./deploy.sh YOUR_HF_USERNAME SPACE_NAME
+# Usage: ./deploy.sh YOUR_HF_USERNAME SPACE_NAME [HF_TOKEN]
 
 set -e
 
 # Check if arguments are provided
 if [ $# -lt 2 ]; then
-    echo "Usage: ./deploy.sh YOUR_HF_USERNAME SPACE_NAME"
+    echo "Usage: ./deploy.sh YOUR_HF_USERNAME SPACE_NAME [HF_TOKEN]"
     echo "Example: ./deploy.sh johndoe qwen-ocr-detection"
+    echo "         ./deploy.sh johndoe qwen-ocr-detection hf_xxxxxxxxxxxx"
+    echo ""
+    echo "Get your token at: https://huggingface.co/settings/tokens"
     exit 1
 fi
 
 HF_USERNAME=$1
 SPACE_NAME=$2
+HF_TOKEN=${3:-$HF_TOKEN}  # Use provided token or environment variable
 
 echo "🚀 Deploying Qwen OCR Detection to Hugging Face Spaces"
 echo "Username: $HF_USERNAME"
@@ -23,14 +27,56 @@ echo ""
 # Check if huggingface-cli is installed
 if ! command -v huggingface-cli &> /dev/null; then
     echo "❌ huggingface-cli not found. Installing..."
-    pip install huggingface_hub
+    pip install --upgrade huggingface_hub
 fi
 
-# Check if logged in
-echo "📝 Checking Hugging Face login..."
-if ! huggingface-cli whoami &> /dev/null; then
-    echo "Please login to Hugging Face:"
-    huggingface-cli login
+# Handle authentication
+echo "📝 Checking Hugging Face authentication..."
+
+# If token is provided, use it
+if [ ! -z "$HF_TOKEN" ]; then
+    echo "Using provided token..."
+    export HF_TOKEN=$HF_TOKEN
+    # Verify token works
+    if ! huggingface-cli whoami 2>/dev/null | grep -q "$HF_USERNAME"; then
+        echo "❌ Token authentication failed or username mismatch!"
+        echo "Please check your token at: https://huggingface.co/settings/tokens"
+        echo "Make sure you're using a WRITE token, not READ."
+        exit 1
+    fi
+    echo "✅ Authentication successful!"
+else
+    # Try to check if already logged in
+    LOGGED_IN_USER=$(huggingface-cli whoami 2>/dev/null | grep "username:" | awk '{print $2}' || echo "")
+    
+    if [ -z "$LOGGED_IN_USER" ]; then
+        echo "❌ Not logged in to Hugging Face!"
+        echo ""
+        echo "Please login using one of these methods:"
+        echo ""
+        echo "Option 1: Run with token:"
+        echo "  ./deploy.sh $HF_USERNAME $SPACE_NAME YOUR_HF_TOKEN"
+        echo ""
+        echo "Option 2: Login interactively:"
+        echo "  huggingface-cli login"
+        echo ""
+        echo "Option 3: Set environment variable:"
+        echo "  export HF_TOKEN=your_token_here"
+        echo ""
+        echo "Get your token at: https://huggingface.co/settings/tokens"
+        echo "Make sure to use a WRITE token, not READ!"
+        exit 1
+    elif [ "$LOGGED_IN_USER" != "$HF_USERNAME" ]; then
+        echo "⚠️  Warning: Logged in as '$LOGGED_IN_USER' but deploying as '$HF_USERNAME'"
+        echo "Continue? (y/n)"
+        read -r response
+        if [[ ! "$response" =~ ^[Yy]$ ]]; then
+            echo "Deployment cancelled."
+            exit 1
+        fi
+    else
+        echo "✅ Already logged in as $HF_USERNAME"
+    fi
 fi
 
 # Initialize git repository if not already initialized
@@ -43,12 +89,41 @@ fi
 
 # Create the Space
 echo "🏗️ Creating Space on Hugging Face..."
-huggingface-cli repo create $SPACE_NAME --type space --space_sdk gradio || echo "Space might already exist, continuing..."
+SPACE_URL="https://huggingface.co/spaces/$HF_USERNAME/$SPACE_NAME"
+
+# Try to create the space (will fail if it already exists, which is OK)
+if huggingface-cli repo create "$HF_USERNAME/$SPACE_NAME" --type space --space_sdk gradio 2>/dev/null; then
+    echo "✅ Space created successfully!"
+else
+    echo "ℹ️  Space might already exist or creation failed, attempting to push anyway..."
+fi
 
-# Add remote and push
-echo "📤 Pushing to Hugging Face..."
-git remote add origin https://huggingface.co/spaces/$HF_USERNAME/$SPACE_NAME 2>/dev/null || git remote set-url origin https://huggingface.co/spaces/$HF_USERNAME/$SPACE_NAME
-git push -u origin main --force
+# Configure git remote
+echo "📤 Configuring git remote..."
+if [ ! -z "$HF_TOKEN" ]; then
+    # Use token in URL for authentication
+    git remote add origin "https://$HF_USERNAME:[email protected]/spaces/$HF_USERNAME/$SPACE_NAME" 2>/dev/null || \
+    git remote set-url origin "https://$HF_USERNAME:[email protected]/spaces/$HF_USERNAME/$SPACE_NAME"
+else
+    # Use standard URL (will use stored credentials)
+    git remote add origin "$SPACE_URL" 2>/dev/null || \
+    git remote set-url origin "$SPACE_URL"
+fi
+
+# Push to Hugging Face
+echo "📤 Pushing to Hugging Face Spaces..."
+if git push -u origin main --force; then
+    echo "✅ Push successful!"
+else
+    echo "❌ Push failed!"
+    echo ""
+    echo "Troubleshooting:"
+    echo "1. Check your authentication token has WRITE permissions"
+    echo "2. Verify the Space URL: $SPACE_URL"
+    echo "3. Try creating the Space manually at: https://huggingface.co/new-space"
+    echo "4. Then run: git push -u origin main --force"
+    exit 1
+fi
 
 echo ""
 echo "✅ Deployment complete!"

test_fonts.py

@@ -0,0 +1,111 @@
+#!/usr/bin/env python3
+"""
+Test script to check available fonts on Hugging Face Spaces
+Upload this to debug font issues
+"""
+
+import os
+import subprocess
+from PIL import ImageFont
+
+def list_system_fonts():
+    """List all available system fonts."""
+    print("=== System Fonts ===\n")
+    
+    # Common font directories on Linux
+    font_dirs = [
+        "/usr/share/fonts",
+        "/usr/local/share/fonts",
+        "/usr/X11R6/lib/X11/fonts",
+        "~/.fonts"
+    ]
+    
+    for font_dir in font_dirs:
+        expanded_dir = os.path.expanduser(font_dir)
+        if os.path.exists(expanded_dir):
+            print(f"\n📁 {font_dir}:")
+            for root, dirs, files in os.walk(expanded_dir):
+                for file in files:
+                    if file.endswith(('.ttf', '.ttc', '.otf', '.otc')):
+                        full_path = os.path.join(root, file)
+                        # Only show CJK related fonts
+                        if 'cjk' in file.lower() or 'noto' in file.lower() or 'chinese' in file.lower() or 'japanese' in file.lower() or 'korean' in file.lower():
+                            print(f"  ✓ {full_path}")
+
+def test_font_loading():
+    """Test loading specific fonts."""
+    print("\n=== Font Loading Test ===\n")
+    
+    test_paths = [
+        "/usr/share/fonts/opentype/noto/NotoSansCJK-Regular.ttc",
+        "/usr/share/fonts/truetype/noto-cjk/NotoSansCJK-Regular.ttc",
+        "/usr/share/fonts/opentype/noto/NotoSerifCJK-Regular.ttc",
+        "/usr/share/fonts/truetype/liberation/LiberationSans-Regular.ttf",
+        "/usr/share/fonts/truetype/dejavu/DejaVuSans.ttf",
+    ]
+    
+    for font_path in test_paths:
+        try:
+            font = ImageFont.truetype(font_path, size=14)
+            print(f"✅ Successfully loaded: {font_path}")
+        except Exception as e:
+            print(f"❌ Failed to load: {font_path}")
+            print(f"   Error: {e}")
+
+def check_fc_list():
+    """Use fc-list to find CJK fonts."""
+    print("\n=== fc-list CJK Fonts ===\n")
+    
+    try:
+        result = subprocess.run(['fc-list', ':lang=ja'], capture_output=True, text=True)
+        if result.stdout:
+            print("Japanese fonts:")
+            for line in result.stdout.strip().split('\n')[:5]:  # Show first 5
+                print(f"  {line}")
+        
+        result = subprocess.run(['fc-list', ':lang=zh'], capture_output=True, text=True)
+        if result.stdout:
+            print("\nChinese fonts:")
+            for line in result.stdout.strip().split('\n')[:5]:  # Show first 5
+                print(f"  {line}")
+                
+        result = subprocess.run(['fc-list', ':lang=ko'], capture_output=True, text=True)
+        if result.stdout:
+            print("\nKorean fonts:")
+            for line in result.stdout.strip().split('\n')[:5]:  # Show first 5
+                print(f"  {line}")
+    except Exception as e:
+        print(f"fc-list not available: {e}")
+
+def check_packages():
+    """Check if font packages are installed."""
+    print("\n=== Installed Font Packages ===\n")
+    
+    packages = ['fonts-noto-cjk', 'fonts-noto-cjk-extra', 'fonts-liberation', 'fonts-dejavu-core']
+    
+    for package in packages:
+        try:
+            result = subprocess.run(['dpkg', '-l', package], capture_output=True, text=True)
+            if result.returncode == 0 and 'ii' in result.stdout:
+                print(f"✅ {package} is installed")
+            else:
+                print(f"❌ {package} is NOT installed")
+        except Exception as e:
+            print(f"❌ Could not check {package}: {e}")
+
+if __name__ == "__main__":
+    print("🔍 Font Availability Test for Hugging Face Spaces\n")
+    print("=" * 50)
+    
+    check_packages()
+    list_system_fonts()
+    test_font_loading()
+    check_fc_list()
+    
+    print("\n" + "=" * 50)
+    print("\n✅ Font test complete!")
+    print("\nIf fonts are missing, make sure packages.txt includes:")
+    print("  fonts-noto-cjk")
+    print("  fonts-noto-cjk-extra")
+    print("  fonts-liberation")
+    print("  fonts-dejavu-core")

update_space.sh

@@ -0,0 +1,39 @@
+#!/bin/bash
+
+# Script to update the Hugging Face Space with fixes
+
+echo "🔧 Updating Hugging Face Space with fixes..."
+echo ""
+
+# Check if git is initialized
+if [ ! -d .git ]; then
+    echo "❌ Not in a git repository. Please run deploy.sh first."
+    exit 1
+fi
+
+# Add and commit changes
+echo "📦 Committing fixes..."
+git add app.py requirements.txt app_simple.py packages.txt
+git commit -m "Fix: Gradio compatibility and CJK font support
+
+- Updated Gradio to stable version 4.19.2
+- Fixed launch configuration for HF Spaces
+- Added packages.txt to install CJK fonts
+- Updated font paths for Linux/HF Spaces
+- Added simplified fallback version (app_simple.py)
+- Relaxed dependency versions for better compatibility"
+
+# Push to Hugging Face
+echo "📤 Pushing updates..."
+if git push origin main; then
+    echo "✅ Updates pushed successfully!"
+    echo ""
+    echo "The Space should rebuild automatically. Check the logs on Hugging Face."
+    echo ""
+    echo "If the main app still has issues, you can switch to app_simple.py:"
+    echo "1. Go to your Space settings"
+    echo "2. Change 'app_file' from 'app.py' to 'app_simple.py'"
+else
+    echo "❌ Push failed. Please check your authentication and try again."
+    exit 1
+fi