README_STARTUP.md

🚀 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:

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

cd c:\Users\Administrador\cora
python api.py

Wait for: Uvicorn running on http://0.0.0.0:8000

Terminal 2 - Gradio UI

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:

  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:

  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!