Gratuito · Open Source · Self-Hosted

EverShelf

La tua dispensa intelligente — tieni traccia del cibo, scansiona barcode, ricevi ricette AI Gemini e gestisci la cucina con bilancia BLE integrata e Kiosk Android. Gratis per sempre.

🆓 100% Gratuito 🔓 Open Source MIT 🏠 Self-Hosted 🤖 AI Gemini Integrato ⚖️ Bilancia BLE Integrata
⭐ Vedi su GitHub 📱 Prova la Demo 🚀 Installa Gratis
Scopri di più
20+
Funzioni Chiave
5
Lingue (IT/EN/DE/FR/ES)
v1.7.12
Ultima Versione
€0
Costo Per Sempre
—
⭐ GitHub Stars
📱 Demo Interattiva

Provalo adesso, gratis

Nessuna registrazione. Nessuna installazione. La demo completa gira direttamente nel tuo browser.

🍎 🥦 🥕 🍋 🍇 🫐 🥑 🍅 🧅 🥒
EverShelf
Demo in manutenzione
La demo non è raggiungibile al momento. Torna tra qualche minuto.
👆 Tocca per usare la demo
� DEMO IN MANUTENZIONE
📺 Video Ufficiali

Guarda EverShelf in azione

Scopri tutte le funzionalità: gestione inventario, scanner barcode, AI Gemini, ricette, lista spesa Bring! e molto altro.

EverShelf: Basta Sprechi! La tua dispensa diventa Smart

🇮🇹 Italiano

EverShelf – Your Pantry's Best Friend (Open Source & Self-Hosted)

🇬🇧 English
▶ Canale YouTube 📱 Apri Demo Intera
🆕
Novità Recenti — v1.7.12
✦ Banner "Usa prima" — data scadenza calcolata vs. reale corretta
✦ Ricette "Usa TUTTO" — non cancella più la riga di inventario
✦ Ricette: qty in grammi vs pezzi — AI istruita a usare unità corretta
✦ Nuova chiave i18n use.expiry_warning_opened in IT/EN/DE
✦ caricamento changelog…
✨ Funzionalità

Tutto ciò di cui hai bisogno

Passa il mouse su ogni card per scoprire tutti i dettagli.

📦
Gestione Inventario
Dispensa, frigo e freezer con scadenze intelligenti, posizioni custom e rilevamento anomalie.
  • ✓Scansione barcode con fotocamera (QuaggaJS)
  • ✓Dispensa, Frigo, Freezer e posizioni custom
  • ✓Prodotti aperti: scadenza ridotta dall’apertura
  • ✓Sottovuoto: scadenza estesa automaticamente
  • ✓Banner anomalie con correzione in un tap
  • ✓Protezione quantità con animazione shake
ℹ Passa il mouse per i dettagli
🤖
AI Gemini Integrata
Gemini identifica prodotti, legge scadenze, genera ricette e stima prezzi della spesa.
  • ✓Identificazione foto + match prodotti esistenti
  • ✓Lettura data scadenza da etichetta
  • ✓Generazione ricette streaming (SSE)
  • ✓Chat AI conosce dispensa e preferenze
  • ✓Hint posizione + scadenza AI inline
  • ✓Stima prezzi AI sulla lista spesa
  • ✓“🤖 Spiega”: anomalie in linguaggio naturale
  • ✓Fallback 2.5-flash → 2.0-flash + stato no-chiave
ℹ Passa il mouse per i dettagli
🛒
Lista Spesa Smart
Integrazione con Bring!, previsioni AI sui consumi futuri, aggiunta automatica quando un prodotto finisce e rimozione alla scansione.
  • ✓Sync bidirezionale con Bring! shopping app
  • ✓Nomi generici per lista pulita e organizzata
  • ✓Auto-aggiunta a zero scorte, senza conferma
  • ✓Previsioni smart basate su consumo storico
  • ✓Stima prezzo AI per articolo
ℹ Passa il mouse per i dettagli
🍳
Modalità Cucina
Guida passo-passo a schermo intero con voce (TTS), timer automatico, avvisi vocali e tracciamento ingredienti usati.
  • ✓TTS: browser, Android TTS o REST endpoint
  • ✓Lettura automatica ad ogni tap su Avanti/Indietro
  • ✓Conto alla rovescia vocale 10s prima della fine timer
  • ✓"Buon appetito!" parlato all'ultimo step
ℹ Passa il mouse per i dettagli
📊
Dashboard Anti-Spreco
Consumati vs sprecati, prodotti aperti, stime freezer USDA/EFSA e analisi nutrizionale.
  • ✓Report spreco vs media italiana + kg/anno
  • ✓Pannello prodotti aperti + scadenza ricalcolata
  • ✓Stime freezer USDA/EFSA per categoria
  • ✓Banner: ✅ sicuro, 👀 controlla, 🚫 pericolo
  • ✓Analisi nutrizionale + punteggi salute
  • ✓Skeleton loading stat card
ℹ Passa il mouse per i dettagli
📱
Progressive Web App
Mobile-first, installabile su iOS/Android, multi-dispositivo e aggiornamenti real-time.
  • ✓Design ottimizzato per smartphone e desktop
  • ✓Installabile su schermata home (PWA)
  • ✓3 lingue: IT / EN / DE — 347 chiavi
  • ✓Update detection: pill header ogni 30 min
  • ✓Multi-dispositivo sullo stesso server
ℹ Passa il mouse per i dettagli
⚖️
Bilancia Smart BLE
Integrata nel Kiosk v1.6.0+. Nessuna app esterna. Peso automatico per g/ml, 100+ modelli.
  • ✓GatewayService nel Kiosk (no app esterna)
  • ✓Scan BLE live nel wizard setup
  • ✓100+ modelli (Xiaomi Mi Scale 2…)
  • ✓Diagnostica live in Impostazioni
  • ✓Auto-confirm 10s stabilità + 5s countdown
ℹ Passa il mouse per i dettagli
📺
Add-on
Kiosk Android
Tablet da parete con bilancia BLE integrata, wizard 6 step, TTS nativo e OTA automatico.
  • ✓Kiosk lock vero (lockTask mode)
  • ✓Bilancia BLE integrata (GatewayService)
  • ✓Wizard 6 step con autodiscovery LAN (60 thread)
  • ✓TTS Android nativo (no Web Speech API)
  • ✓OTA automatico ogni 6h
  • ✓Screensaver nutrizionale animato
ℹ Passa il mouse per i dettagli
🆚 Confronto

EverShelf vs le Alternative

Un confronto obiettivo con le soluzioni self-hosted più popolari per la gestione della cucina. Ogni progetto ha la sua vocazione — scegli quello che si adatta meglio alle tue esigenze.

Funzione EverShelf Grocy Mealie KitchenOwl
Gestione dispensa / frigo / freezer ✅ ✅ ❌ ⚠️ base
Scansione barcode con camera ✅ ✅ ❌ ❌
Open Food Facts ✅ ✅ ❌ ❌
Tracking lotto / scadenze (FIFO) ✅ ✅ Molto maturo ❌ ❌
Lista spesa ✅ Bring! nativo ⚠️ plugin community ✅ da ricette ✅ funzione principale
Gestione ricette ⚠️ solo AI ⚠️ manuali ✅ funzione principale ✅
Pianificazione pasti ❌ ⚠️ base ✅ funzione principale ✅
AI integrata (Google Gemini) ✅ UNICO ❌ ⚠️ parsing ricette ❌
Ricette generate dall'AI ✅ UNICO ❌ ❌ ❌
Bilancia BLE integrata ✅ UNICO ❌ Richiede HA ❌ ❌
App Kiosk Android dedicata ✅ UNICO ❌ Solo browser ❌ ❌
App mobile nativa (iOS / Android) ❌ ❌ solo terze parti ❌ solo PWA ✅
Multi-utente ❌ In roadmap ✅ ✅ ✅
Gestione casa (attività, batterie…) ❌ ✅ ❌ ⚠️ attività base
Plugin / ecosystem ❌ ✅ Molto grande ❌ ❌
PWA installabile ✅ ✅ ✅ ✅
Open Source / Gratuito / Self-hosted ✅ MIT ✅ MIT ✅ AGPL ✅ AGPL
Community & maturità Giovane (2026) Grande (dal 2017) Grande (dal 2021) Media (dal 2021)

Ogni strumento ha la sua vocazione: Grocy per la gestione casa completa, Mealie per pianificare i pasti, KitchenOwl per le liste spesa con l'app nativa. EverShelf è la scelta per chi vuole AI, bilancia BLE e kiosk Android — tutto senza configurazioni extra.

💎 Il Valore

Gratis. Per sempre. Davvero.

EverShelf non ha piani premium, abbonamenti nascosti o telemetria. È tuo, sul tuo server, per sempre.

🆓
100% Gratuito
Nessun costo di licenza, nessun abbonamento, nessuna funzione bloccata. Gratis oggi, domani e per sempre.
🔓
Open Source MIT
Licenza MIT. Codice sorgente pubblico su GitHub. Studia, modifica, migliora e condividi liberamente.
🏠
Self-Hosted
I tuoi dati restano sul tuo server. Nessun cloud esterno, nessuna telemetria, privacy totale.
🚀 Installazione

Operativo in 3 Minuti

Due metodi: Docker (consigliato) o manuale su Apache/Nginx con PHP 8.0+.

✅ Consigliato
🐳
Opzione A: Docker
Il modo più semplice. Un comando e sei pronto.
# 1. Clona il repository git clone https://github.com/dadaloop82/EverShelf.git cd EverShelf # 2. Configura cp .env.example .env && nano .env # 3. Avvia docker compose up -d # → http://localhost:8080
⚙️
Opzione B: Manuale
Richiede PHP 8.0+ con pdo_sqlite, curl, mbstring.
git clone https://github.com/dadaloop82/EverShelf.git cd EverShelf cp .env.example .env chmod 755 data/ chown -R www-data:www-data data/ nano .env # → Configura Apache/Nginx
📋 Requisiti
PHP 8.0+  ·  SQLite 3  ·  Apache / Nginx  ·  HTTPS consigliato (fotocamera)
🔑 AI opzionale
API key Google Gemini gratuita su aistudio.google.com
Guida Completa →
🤝 Community

Contribuisci o Forkalo!

EverShelf è un progetto aperto. Chiunque può contribuire, suggerire funzionalità, segnalare bug o tradurre l'app. Il codice è tuo: forkalo liberamente!

1
🍴
Forka
Crea la tua copia su GitHub
2
🌿
Branch
Crea un ramo per la tua funzione
3
💻
Sviluppa
Scrivi codice e committa
4
🚀
Pull Request
Invia la PR e diventa parte del progetto!
🍴 Forka su GitHub 🐛 Segnala un Bug 📖 Guida Contribuzione
🌐 Aiuta con le Traduzioni
Supporta già Italiano, Inglese e Tedesco (347 chiavi). Vuoi aggiungere la tua lingua? Copia translations/it.json, traduci i valori e invia una PR!
🗺️ Roadmap

Cosa sta arrivando

Funzionalità pianificate e recentemente completate. Aggiornato quotidianamente dal README ufficiale.

🔮 In Arrivo
○
Multi-utente — Autenticazione e supporto per più account
○
Offline mode — Service worker per l'uso senza connessione
○
Export / Import — Backup e ripristino dati inventario
○
Notifiche — Avvisi scadenze via Telegram o email
✅ Recentemente Completato
✓
Kiosk OTA update
✓
BLE Scale gateway integrato (Kiosk v1.6+)
✓
Nutrition analysis dashboard
✓
Error reporting automatico
✓
AI price estimation lista spesa

📋 Vedi roadmap completa su GitHub →

❓ FAQ

Domande Frequenti

Aggiornato dalla GitHub Wiki · Ultimo aggiornamento:

Funziona senza chiave API Gemini? ▶
Sì. Tutte le funzioni AI sono opzionali e degradano silenziosamente. Senza chiave, l'icona AI nell'header diventa grigia con un punto ambra. Inventario, scansione barcode e tutto il resto funzionano normalmente.
I miei dati vanno nel cloud? ▶
No. Tutti i dati restano sul tuo server in un database SQLite locale e non vengono mai inviati a server remoti. Le uniche eccezioni sono le chiamate AI opzionali verso Google Gemini e le lookup su Open Food Facts per i barcode sconosciuti.
La fotocamera / scanner barcode non funziona ▶
L'accesso alla fotocamera richiede HTTPS. Se accedi via http:// il browser blocca la camera. Usa Let's Encrypt, un certificato auto-firmato o un reverse proxy come Caddy per abilitare TLS.
Come configuro l'integrazione Bring!? ▶
Aggiungi BRING_EMAIL e BRING_PASSWORD al file .env e riavvia il server. La tab spesa mostrerà automaticamente la tua lista Bring!. Senza credenziali viene mostrato un messaggio con il link alle impostazioni.
La bilancia BLE non mostra il peso ▶
Con il Kiosk v1.6+ la bilancia BLE è integrata: nessuna app esterna necessaria. Verifica la connessione nelle impostazioni. Per installazioni non-kiosk, verifica che l'URL del gateway in Impostazioni corrisponda esattamente e che entrambi siano sulla stessa rete.
Le funzioni AI non funzionano ▶
Verifica che GEMINI_API_KEY sia correttamente impostata nel file .env. Controlla la quota disponibile su aistudio.google.com. L'app usa gemini-2.5-flash con fallback automatico a gemini-2.0-flash.
L'app mostra una pagina bianca ▶
Verifica che PHP 8.0+ sia in esecuzione. Apri api/index.php?action=get_settings nel browser: dovresti vedere una risposta JSON. Se vedi un errore PHP, controlla i log del server web.
Il container Docker si chiude subito ▶
Quasi certamente un problema di permessi sulla directory data/. Esegui chmod 755 data/ dalla root del progetto, poi riavvia il container.
La versione mostrata è obsoleta ▶
Fai un hard refresh: Ctrl+Shift+R su Windows/Linux o Cmd+Shift+R su macOS. Nel Kiosk usa il bottone ↻ in alto a destra per svuotare la cache della WebView.

📖 Vedi tutte le FAQ su GitHub Wiki →

👨‍💻 L'Autore

Chi c'è dietro EverShelf

👨‍💻
Stimpfl Daniel
Creatore & Sviluppatore di EverShelf
Ho creato EverShelf per risolvere un problema reale: sapere cosa c'è in casa, ridurre gli sprechi e cucinare meglio con quello che ho. È un progetto personale che condivido liberamente con la community — gratuito, open source e self-hosted, perché i tuoi dati appartengono solo a te.
@dadaloop82 evershelfproject@gmail.com ⭐ Metti una stella! ▶ Canale YouTube