docs: aggiorna README e documentazione con feature attuali
This commit is contained in:
@@ -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
|
||||
|
||||
Reference in New Issue
Block a user