docs: aggiorna README e documentazione con feature attuali

This commit is contained in:
Luca Sacchi Ricciardi
2026-04-25 18:10:49 +02:00
parent bfed2f60aa
commit 831b41f487
3 changed files with 116 additions and 39 deletions
+53 -29
View File
@@ -4,13 +4,16 @@ Una dashboard web moderna e intuitiva per monitorare e gestire i modelli LLM car
## 🎯 Caratteristiche
-**Dashboard intuitiva** - Visualizza in tempo reale i modelli caricati in Ollama
-**Dashboard intuitiva** - Visualizza in tempo reale i modelli disponibili e in esecuzione su Ollama
- 📊 **Monitoraggio modelli** - Dettagli completi di ogni modello (nome, dimensione, memoria, stato)
- 🧩 **Dettagli avanzati on click** - Clic su una card modello per visualizzare i dati Ollama `show`
- 🧩 **Dettagli accordion on click** - Clic su una card per esplorare i dati `ollama show` in pannelli collassabili (dettagli, parametri, template, modelfile, licenza)
- 🖥️ **Multi-server** - Gestione di più istanze Ollama con switch istantaneo (pagina `/servers`)
- 🏃 **Modelli in esecuzione** - Pagina dedicata `/models-running` con VRAM, tempo rimanente e backend GPU/CPU
- 📱 **PWA** - Installabile come app desktop/mobile con Service Worker e cache offline
- 🔌 **API REST documentata** - Documentazione interattiva con Swagger/OpenAPI
- 🎨 **UI moderna** - Interfaccia elegante realizzata con TailwindCSS
- 🐳 **Docker ready** - Container sempre acceso (until stopped)
-**Performance** - Costruito su FastAPI e uVicorn
- 🎨 **UI moderna** - Interfaccia dark-mode realizzata con TailwindCSS
- 🐳 **Docker ready** - Container sempre acceso (restart: unless-stopped)
-**Performance** - FastAPI + uVicorn, aggiornamenti ogni 30s via Web Worker senza bloccare l'UI
- 🔐 **Configurazione flessibile** - File `.env` per personalizzazione
## 📋 Requisiti
@@ -309,38 +312,59 @@ docker start llm-monitor
llm-monitor/
├── main.py # Entry point dell'applicazione
├── requirements.txt # Dipendenze Python
├── env.example # Esempio di configurazione
├── Dockerfile # Configurazione Docker
├── docker-compose.yml # Composizione servizi
├── README.md # Questo file
├── .gitignore
├── requirements-dev.txt # Dipendenze sviluppo (pytest, black, flake8…)
├── env.example # Esempio di configurazione
├── Dockerfile # Build multi-stage (Node CSS + Python runtime)
├── docker-compose.yml # Composizione servizi
├── package.json # Script Node (Tailwind, Playwright)
├── tailwind.config.js # Configurazione TailwindCSS
├── playwright.config.js # Configurazione test E2E
├── Makefile # Comandi rapidi (dev, test, deploy…)
├── README.md # Questo file
├── CONTRIBUTING.md # Guida ai contributi
├── app/
│ ├── __init__.py
│ ├── config.py # Configurazione (variabili ambiente)
│ ├── main.py # Inizializzazione FastAPI
│ ├── config.py # Configurazione via variabili d'ambiente
│ │
│ ├── api/
│ │ ├── __init__.py
│ │ ── models.py # Endpoint modelli
│ │ ├── health.py # Endpoint health
│ │ └── v1/
│ │ └── __init__.py
│ │ ├── models.py # Endpoint modelli (/api/v1/models)
│ │ ── health.py # Endpoint health (/api/v1/health)
│ │
│ ├── services/
│ │ ── __init__.py
│ │ ├── ollama.py # Client Ollama
│ │ └── cache.py # Cache in-memory (opzionale)
│ │ ── ollama.py # Client HTTP verso Ollama
│ │
│ └── web/
│ ├── __init__.py
├── static/ # Assets statici (CSS compilato TailwindCSS)
└── templates/ # Template HTML
│ ├── static/
│ ├── css/
│ │ ├── input.css # Sorgente Tailwind
│ │ │ └── output.css # CSS compilato (generato)
│ │ └── js/
│ │ ├── app.js # App principale (dashboard modelli)
│ │ ├── servers.js # Pagina gestione server
│ │ ├── models-running.js # Pagina modelli in esecuzione
│ │ ├── data-sync.worker.js # Web Worker sincronizzazione dati
│ │ ├── server-config.js # Utilità multi-server e localStorage
│ │ ├── pwa-register.js # Registrazione Service Worker
│ │ └── service-worker.js # PWA Service Worker (cache-first)
│ └── templates/
│ ├── index.html # Dashboard modelli disponibili
│ ├── servers.html # Gestione istanze Ollama
│ └── models_running.html # Modelli attualmente in esecuzione
├── docs/
│ ├── PRD.md # Product Requirements Document
│ ├── DEVELOPMENT.md # Guida al setup e sviluppo locale
│ └── WEB_WORKERS.md # Architettura Web Worker e PWA
├── scripts/
│ ├── deploy-no-cache.sh # Deploy Docker con rebuild forzato
│ └── verify-tailwind-css.sh # Verifica CSS compilato in container
└── tests/
├── __init__.py
├── test_api.py
└── test_ollama.py
├── test_api.py # Unit test endpoint FastAPI
├── test_ollama.py # Unit test client Ollama
└── e2e/
└── cache-navigation.spec.js # Test E2E Playwright (cache/PWA)
```
## 🛠️ Sviluppo
@@ -453,6 +477,6 @@ Per domande o segnalazioni di bug, apri un **Issue** nel repository.
**Fatto con ❤️ da [LucaSacchi.Net](https://lucasacchi.net)**
**Versione**: 1.0.0
**Versione**: 1.1.0
**Ultima modifica**: Aprile 2026
**Status**: 🟢 In Development
**Status**: 🟢 Active