# 🚀 Cora Startup Guide

## Quick Start (Recommended)

### Option 1: PowerShell Script (Recommended)
1. Right-click `start_cora.ps1`
2. Select **"Run with PowerShell"**
3. Wait for both windows to open
4. Open your browser → **http://localhost:7861**

**OR** from PowerShell:
```powershell
cd c:\Users\Administrador\cora
.\start_cora.ps1
```

---

### Option 2: Batch Script (Older Windows)
1. Double-click `start_cora.bat`
2. Wait for both windows to open
3. Open your browser → **http://localhost:7861**

---

## Manual Start (If Scripts Fail)

### Terminal 1 - API Backend
```powershell
cd c:\Users\Administrador\cora
python api.py
```
Wait for: `Uvicorn running on http://0.0.0.0:8000`

### Terminal 2 - Gradio UI
```powershell
cd c:\Users\Administrador\cora
python ui.py
```
Wait for: `Running on local URL:  http://127.0.0.1:7861`

---

## URLs

| Service | URL | Purpose |
|:--------|:----|:--------|
| **Gradio UI** | http://localhost:7861 | Main user interface |
| **API Backend** | http://localhost:8000 | FastAPI server |
| **API Docs** | http://localhost:8000/docs | Interactive API documentation |
| **Health Check** | http://localhost:8000/health | Server status |

---

## Troubleshooting

### "Python not found"
- Install Python 3.11+
- Add Python to PATH

### "Port already in use"
- Kill existing processes:
  ```powershell
  Get-Process | Where-Object {$_.ProcessName -like "*python*"} | Stop-Process
  ```

### "Connection Refused"
- Make sure **API is running first** (port 8000)
- Then start the UI (port 7861)

### "Module not found"
- Install dependencies:
  ```powershell
  pip install -r requirements.txt
  ```

---

## What's New (Recent UI Upgrade)

✅ **Progress Indicators** - Real-time feedback during generation  
✅ **Responsive Layout** - Mobile-friendly gallery (1/2/3 columns)  
✅ **User-Friendly Errors** - Clear, actionable error messages  
✅ **Input Examples** - 6 curated prompts you can click to use  
✅ **Enhanced Visual Hierarchy** - Better copy and value proposition  
✅ **Micro-Interactions** - Smooth hover/active/focus states  

**Upgraded from Grade C- to A** on 2026 responsive & UX/UI standards!