# 🚀 Hugging Face Spaces Deployment Guide

## Quick Start

### Option 1: Automated Setup (Recommended)
```bash
# 1. Setup the repository
python setup_hf_space.py

# 2. Push to Hugging Face Spaces
python push_to_hf_space.py
```

### Option 2: Manual Setup
Follow the steps below for manual deployment.

## 📋 Prerequisites

1. **Git installed** on your system
2. **Hugging Face account** (free)
3. **Python 3.8+** installed
4. **All project files** in the current directory

## 🌐 Step 1: Create Hugging Face Space

1. Go to [Hugging Face Spaces](https://huggingface.co/spaces)
2. Click **"Create new Space"**
3. Fill in the details:
   - **Name**: `textilindo-ai-assistant`
   - **SDK**: **Docker**
   - **Hardware**: **GPU Basic** (recommended) or **CPU Basic**
   - **Visibility**: Public or Private
4. Click **"Create Space"**
5. **Copy the repository URL** (e.g., `https://huggingface.co/spaces/your-username/textilindo-ai-assistant`)

## 🔧 Step 2: Setup Git Repository

```bash
# Initialize git repository (if not already done)
git init

# Add your Hugging Face Space as remote
git remote add origin https://huggingface.co/spaces/your-username/textilindo-ai-assistant

# Verify remote
git remote -v
```

## 📁 Step 3: Prepare Files

The following files are already prepared for you:

- ✅ `README.md` - Space configuration
- ✅ `Dockerfile` - Optimized for HF Spaces
- ✅ `requirements.txt` - Fixed dependencies
- ✅ `app.py` - Main entry point
- ✅ `app_hf_spaces.py` - Web interface
- ✅ `health_check.py` - Health monitoring
- ✅ All scripts in `scripts/` directory

## 🚀 Step 4: Deploy to Hugging Face Spaces

```bash
# Add all files to git
git add .

# Commit changes
git commit -m "Initial commit: Textilindo AI Assistant"

# Push to Hugging Face Spaces
git push origin main
```

## ⏳ Step 5: Monitor Build

1. Go to your Hugging Face Space
2. Check the **"Logs"** tab
3. Wait for the build to complete (5-10 minutes)
4. The Space will automatically start when ready

## 🎯 Step 6: Test Your Space

1. **Visit your Space URL**: `https://huggingface.co/spaces/your-username/textilindo-ai-assistant`
2. **Check Health**: Visit `/health` endpoint
3. **Test Interface**: Use the web interface to run scripts
4. **Monitor Logs**: Check for any errors

## ⚙️ Step 7: Configure Environment Variables (Optional)

In your Space settings, add:

- `HUGGINGFACE_TOKEN`: Your Hugging Face token (for model downloads)
- `NOVITA_API_KEY`: Your Novita AI API key (for external training)

## 🔍 Troubleshooting

### Build Failures
- Check the build logs in your Space
- Verify all files are present
- Ensure Dockerfile is in the root directory

### Runtime Errors
- Check the Space logs
- Verify environment variables
- Test individual scripts

### Memory Issues
- Use GPU Basic or higher hardware
- Consider using smaller models
- Check resource usage in logs

## 📊 Expected Results

After successful deployment:

✅ **Space builds** without errors  
✅ **Web interface** accessible  
✅ **Health endpoint** returns healthy status  
✅ **All scripts** executable via interface  
✅ **Training process** can be initiated  

## 🎉 Success!

Your Textilindo AI Assistant is now deployed on Hugging Face Spaces!

### Features Available:
- 🤖 **AI Model Training** with LoRA
- 📊 **Dataset Creation** and management
- 🧪 **Model Testing** and inference
- 🔗 **External Service** integration
- 📱 **Web Interface** for all operations

### Next Steps:
1. **Test the interface** with sample data
2. **Train your first model** using the web interface
3. **Share your Space** with others
4. **Monitor performance** and logs

## 📞 Support

If you encounter issues:
1. Check the Space logs
2. Verify all files are present
3. Test locally with `python test_build.py`
4. Review the troubleshooting section above

## 🔄 Updates

To update your Space:
1. Make changes to your local files
2. Commit and push: `git push origin main`
3. The Space will automatically rebuild
4. Check build logs for any issues