Prerequisiti

Avere un file .env dentro la cartella backend

File di esempio

# Chiave api
LLM_API_KEY=xx-xxxxxxxxxxxxxxxxxaxxxxx

# Url Api
LLM_API_URL=http://sito:porta/v1/chat/completions

# Modello
LLM_MODEL=gpt-oss:20b

1 Crea virtual environment python (FastAPI) con requirements.txt

Nella root del progetto esegui il comando: importante avere la versione pyton 3.12.x poichè versioni più recenti risultano instabili

py -3.12 -m venv .venv
.venv\Scripts\activate
pip install -r backend/requirements.txt

Questo comando basta eseguirlo la prima volta e basta

2 Avviare in due terminali attivi contemporaneamente backend e frontend

2.1 Avvio backend

.venv\Scripts\activate
cd backend
uvicorn app.main:app --reload

2.2 Avvio frontend

2.2.1 Avvio frontend user

cd frontend
npm install
npm run build
npm run preview

2.2.1 Avvio frontend developer

cd frontend
npm run dev

Se non funziona, segui questi passi:

1️⃣ Verifica installazione Python

In PowerShell / CMD:

python --version

2️⃣ Crea un virtual environment (se non esiste)

Nella root del progetto:

py -3.12 -m venv .venv

3️⃣ Attiva il virtualenv (Windows) .venv\Scripts\activate

Dovresti vedere:

(.venv) PS C:\tuo\progetto>

⚠️ Se non vedi (venv) NON è attivo

4️⃣ Installa FastAPI + Uvicorn pip install fastapi uvicorn

Verifica:

uvicorn --version

5️⃣ Avvia FastAPI (comando corretto)

⚠️ devi essere nella cartella backend (oppure adattare il path)

uvicorn app.main:app --reload

React + TypeScript + Vite

This template provides a minimal setup to get React working in Vite with HMR and some ESLint rules.

Currently, two official plugins are available:

• @vitejs/plugin-react uses Babel (or oxc when used in rolldown-vite) for Fast Refresh
• @vitejs/plugin-react-swc uses SWC for Fast Refresh