| # 🚀 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! | |