QUICK_DEPLOY.md

Quick Deployment Guide

🚀 One-Command Deployment

For macOS/Linux:

chmod +x deploy.sh && ./deploy.sh

For Windows:

deploy.bat

📋 Platform-Specific Commands

Local Development

# Auto-detect best method
./deploy.sh

# Force Docker
./deploy.sh docker

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

Cloud Platforms

# Hugging Face Spaces
./deploy.sh hf-spaces

# Railway
./deploy.sh cloud railway

# Render  
./deploy.sh cloud render

# Heroku
./deploy.sh cloud heroku

Management Commands

# Check status
./deploy.sh status

# Stop all services
./deploy.sh stop

# Show help
./deploy.sh help

🔧 Environment Setup

1. Copy environment file:

   cp .env.example .env
   

2. Edit configuration as needed:

   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.