# Quick Deployment Guide

## 🚀 One-Command Deployment

### For macOS/Linux:
```bash
chmod +x deploy.sh && ./deploy.sh
```

### For Windows:
```cmd
deploy.bat
```

## 📋 Platform-Specific Commands

### Local Development
```bash
# Auto-detect best method
./deploy.sh

# Force Docker
./deploy.sh docker

# Force standalone (no Docker)
./deploy.sh standalone
```

### Cloud Platforms
```bash
# Hugging Face Spaces
./deploy.sh hf-spaces

# Railway
./deploy.sh cloud railway

# Render  
./deploy.sh cloud render

# Heroku
./deploy.sh cloud heroku
```

### Management Commands
```bash
# Check status
./deploy.sh status

# Stop all services
./deploy.sh stop

# Show help
./deploy.sh help
```

## 🔧 Environment Setup

1. Copy environment file:
   ```bash
   cp .env.example .env
   ```

2. Edit configuration as needed:
   ```bash
   nano .env
   ```

## 🌐 Access URLs

- **Frontend**: http://localhost:8501
- **Backend API**: http://localhost:8001
- **API Docs**: http://localhost:8001/docs

## 🐛 Troubleshooting

### Common Issues
1. **Port conflicts**: Change DEFAULT_PORT in deploy.sh
2. **Python not found**: Install Python 3.8+
3. **Docker issues**: Ensure Docker is running
4. **Model loading**: Check internet connection

### Platform Issues
- **HF Spaces**: Check app_file in README.md header
- **Railway/Render**: Verify Dockerfile.standalone exists
- **Heroku**: Ensure Procfile is created

## 📞 Quick Support
Run `./deploy.sh status` to check deployment health.