# 🚀 Starting the FastAPI Server

This guide explains how to run the Crypto Intelligence Hub FastAPI server using uvicorn on port 7860.

## Quick Start

### Method 1: Using Python directly (Recommended)
```bash
python main.py
```

### Method 2: Using the run script
```bash
python run_server.py
```

### Method 3: Using uvicorn directly
```bash
uvicorn main:app --host 0.0.0.0 --port 7860
```

## Configuration

### Port Configuration
The server runs on **port 7860** by default (Hugging Face Spaces standard).

You can change the port using environment variables:
```bash
# Windows
set PORT=8000
python main.py

# Linux/Mac
export PORT=8000
python main.py
```

Or for Hugging Face Spaces:
```bash
export HF_PORT=7860
python main.py
```

### Host Configuration
Default host is `0.0.0.0` (listens on all interfaces).

Change it with:
```bash
export HOST=127.0.0.1  # Only localhost
python main.py
```

### Development Mode (Auto-reload)
Enable auto-reload for development:
```bash
export DEBUG=true
python main.py
```

## Access Points

Once the server is running, you can access:

- **Main Dashboard**: http://localhost:7860/
- **API Documentation**: http://localhost:7860/docs
- **System Monitor**: http://localhost:7860/system-monitor
- **OpenAPI Schema**: http://localhost:7860/openapi.json

## Production Deployment

### Hugging Face Spaces
The server is configured to work with Hugging Face Spaces automatically:
- Port 7860 is the default
- Host 0.0.0.0 allows external access
- All optimizations are enabled

### Using Gunicorn (Alternative)
For production with multiple workers:
```bash
gunicorn main:app -w 4 -k uvicorn.workers.UvicornWorker --bind 0.0.0.0:7860
```

## Troubleshooting

### Port Already in Use
If port 7860 is already in use:
```bash
# Find what's using the port
# Windows
netstat -ano | findstr :7860

# Linux/Mac
lsof -i :7860

# Then use a different port
export PORT=8000
python main.py
```

### Module Not Found Errors
Make sure all dependencies are installed:
```bash
pip install -r requirements.txt
```

### Database Connection Issues
The server will continue to run even if database connections fail. Check logs for specific errors.

## Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| `PORT` | `7860` | Server port |
| `HF_PORT` | `7860` | Hugging Face Spaces port (fallback) |
| `HOST` | `0.0.0.0` | Server host |
| `DEBUG` | `false` | Enable auto-reload |

## Logs

The server logs to console with INFO level by default. You'll see:
- Server startup messages
- Router loading status
- Request logs (if access_log=True)
- Error messages

## Stopping the Server

Press `Ctrl+C` to gracefully stop the server.

## Next Steps

1. ✅ Server is running on port 7860
2. 📊 Open the dashboard at http://localhost:7860/
3. 📚 Check API docs at http://localhost:7860/docs
4. 🔍 Monitor system at http://localhost:7860/system-monitor