¿Qué es EverShelf?
EverShelf es una aplicación web autoalojada que registra qué hay en tu despensa, cuándo caduca y qué comprar a continuación. El README la llama «self-hosted pantry manager — inventory, barcode scan, AI recipes, less waste»; está escrita en PHP con una base de datos SQLite y una interfaz de una sola página, y su código es abierto bajo la licencia MIT.
El README acredita a un desarrollador, Stimpfl Daniel (GitHub: dadaloop82), y pide más colaboradores. Una app de iOS sin relación, de Joshumi Technologies, usa el mismo nombre; el README aclara que no hay vínculo.
Dónde conseguirlo
EverShelf es un servidor que instalas tú mismo; la vía documentada es Docker Compose, y los móviles y tablets acceden mediante un navegador o la app de quiosco para Android.
Servidor (Docker Compose)
- Cómo conseguirlo:
- Inicio rápido del README: clona el repositorio, copia .env.example a .env y ejecuta docker compose up -d
Tablet de quiosco Android
- Cómo conseguirlo:
- evershelf-kiosk.apk (versión 1.7.24, Android 7.0 o posterior)
Unraid
- Cómo conseguirlo:
- Plantilla de Community Applications y guía
Sitio web
- Cómo conseguirlo:
- evershelf.site
Aviso de privacidad
- Cómo conseguirlo:
- evershelf.site, sección Privacy: una declaración breve en la página principal; no se encontró un documento de política aparte
Código fuente
- Cómo conseguirlo:
- github.com/dadaloop82/EverShelf
Demo
- Cómo conseguirlo:
- evershelf.site/demo, que según el README incluye IA
Versión revisada: v1.16.16, publicada el 25 de octubre de 2026 según la release de GitHub; el último cambio del repositorio fue el 1 de noviembre de 2026. La instalación requiere un terminal, Docker y un archivo .env editado a mano, así que es una configuración para desarrolladores y no una instalación con doble clic. La lista de releases de GitHub solo incluye el APK de quiosco para Android.
Requisitos
Las fuentes no dan un mínimo de RAM ni de CPU; las necesidades indicadas son Docker o PHP 8.0+, una cámara para escanear y, para la IA, una clave de proveedor o un servidor Llama.
Servidor
- Qué dicen las fuentes:
- Docker con Compose, o un servidor web con PHP 8.0+ apuntando a la raíz del repositorio con una carpeta data/ con permiso de escritura
Almacenamiento
- Qué dicen las fuentes:
- Base de datos SQLite en el volumen de datos; la copia de seguridad integrada se guarda en ese mismo volumen, así que cópiala a otro sitio
Memoria y CPU
- Qué dicen las fuentes:
- No se indica en las fuentes leídas
Cámara
- Qué dicen las fuentes:
- El escaneo de códigos de barras usa la cámara del dispositivo en el navegador (QuaggaJS, según la wiki)
Quiosco
- Qué dicen las fuentes:
- Android 7.0 (API 24) o posterior; compatibilidad opcional con básculas de cocina Bluetooth
IA
- Qué dicen las fuentes:
- Una clave de API de Gemini u OpenAI, o la dirección de un servidor Llama compatible con OpenAI como Ollama, llama.cpp o vLLM
Red
- Qué dicen las fuentes:
- Pensado para una red doméstica de confianza; para acceder desde internet la política de seguridad espera que añadas tu propia capa de autenticación
Estos datos proceden del README, la wiki y SECURITY.md; PromptQuorum no midió el uso de recursos.
Cómo empezar
Estos pasos siguen el README del proyecto; PromptQuorum no los ha ejecutado.
- 1Obtén el código y la plantilla de configuración
Why it matters: Ejecuta git clone del repositorio y copia .env.example a .env en la carpeta del proyecto. - 2Elige el ajuste de IA
Why it matters: En .env, pon AI_ENABLED=false para trabajar sin IA, o establece AI_PROVIDER en gemini, openai o llama y añade la clave o la URL base correspondiente. - 3Inicia el contenedor
Why it matters: Ejecuta docker compose up -d y abre http://localhost:8080; para actualizar más adelante, el README indica docker compose pull y luego docker compose up -d. - 4Empareja tus dispositivos
Why it matters: Si API_TOKEN está definido, la interfaz web pide un código de emparejamiento de un solo uso, que aparece en Ajustes, Sistema, Seguridad en un dispositivo ya emparejado o en el registro del servidor.
Funciones principales
Todo lo que sigue procede del README o de la wiki del proyecto; PromptQuorum no ha probado nada.
- Inventario. Escaneo de códigos de barras, ubicaciones de almacenamiento, fechas de caducidad, envases abiertos, favoritos e importación y exportación en CSV.
- Compras. Una lista de la compra inteligente con cantidades contra el desperdicio, recetas que añaden los ingredientes que faltan tras descontar lo que ya tienes y sincronización opcional con Bring!.
- Cocina. Recetas paso a paso con instrucciones habladas, temporizadores y consejos de desperdicio cero.
- Avisos y calendario. Notificaciones de caducidad mediante ntfy, un webhook JSON o Home Assistant, además de un feed ICS para Google o Apple Calendar.
- Integraciones. Una API REST, un servidor MCP, una integración con Home Assistant en otro repositorio, un Health Bridge con Fuel Mode y el quiosco Android con una pasarela para báscula Bluetooth.
Funciones de IA y dónde se ejecutan
Hay un solo proveedor de IA activo a la vez, elegido en .env: Gemini, OpenAI o «llama», un endpoint compatible con OpenAI que gestionas tú; la IA también se puede desactivar.
- Reconocimiento de productos. La IA identifica un producto a partir de una foto de la cámara y, con una clave de Gemini, se le puede consultar por códigos de barras que otras búsquedas no encuentran.
- Fechas de caducidad. La IA lee una foto de la etiqueta y rellena el campo de caducidad.
- Recetas y chat. La IA escribe recetas con lo que hay en la despensa y ofrece un chat; las recetas también pueden venir de una instancia de Mealie conectada.
- Proveedores. La configuración de ejemplo documenta Gemini, OpenAI con URL base y modelo modificables, y una opción Llama para Ollama, llama.cpp o vLLM. La wiki describe las funciones de IA en términos de Gemini y no indica cuáles funcionan con un modelo local.
- Control de costes. El archivo de ejemplo fija un límite diario de llamadas de clasificación a Gemini y puede estimar el coste en tokens.
Flujo de datos y privacidad
El sitio afirma que el inventario y el historial permanecen en tu dispositivo o servidor doméstico, que la IA es opcional y que no hay telemetría. Las notas de arquitectura describen una base de datos SQLite en la carpeta de datos, y la política de seguridad parte de una red doméstica de confianza.
Peticiones externas que nombran las fuentes: el proveedor de IA que elijas (Gemini u OpenAI, salvo con la opción Llama), Open Food Facts para códigos de barras desconocidos, Open Prices para estimar precios y servicios opcionales como Bring!, ntfy, la copia de seguridad en Google Drive y un enlace de donación de PayPal. Los informes de error van a un registro local con datos ocultos, y enviarlos a GitHub es una segunda aceptación voluntaria. Según el README, un diálogo único ofrece donar o nada, y no se muestra publicidad. La demo pública usa IA en la nube.
📌Nota: Son declaraciones del proyecto, no resultados de una auditoría. PromptQuorum no ha inspeccionado el tráfico de red ni el código fuente.
Para quién es
- Quienes alojan sus propios servicios con un servidor Docker o un NAS y quieren un control privado de despensa y caducidad.
- Hogares que cocinan con lo que tienen y quieren una lista de la compra compartida, avisos de caducidad y recetas hechas con lo disponible.
- Usuarios de Home Assistant que quieren los datos de caducidad y compras en su hogar inteligente o en un agente conectado por MCP.
Lo que no pudimos verificar
- Calidad de la IA. No se probaron el reconocimiento de productos, la lectura de caducidades ni la calidad de las recetas, y las fuentes no dicen qué funciones de IA funcionan con un modelo Llama local.
- Madurez. El proyecto empezó en marzo de 2026 y acredita a un desarrollador; PromptQuorum no evaluó su estabilidad ni su seguridad.
- Documentación de seguridad. SECURITY.md sigue listando 1.7.x como la línea con soporte, muy por detrás de la actual v1.16.16.
- Afirmaciones sobre datos. «Sin telemetría» y «los datos se quedan en casa» son declaraciones del proyecto; no se inspeccionó el tráfico.
- Necesidades de hardware. No hay un mínimo documentado de RAM ni de CPU, y no se comprobó la velocidad en un dispositivo pequeño como una Raspberry Pi.
Competidores y alternativas
El directorio tiene otra reseña de la misma capa de hogar inteligente: un asistente de voz dentro de Home Assistant, la plataforma para la que EverShelf ofrece una integración. El sitio del propio proyecto compara EverShelf con Grocy, Mealie y KitchenOwl; esos gestores de despensa y recetas no están en el directorio y PromptQuorum no verificó esa comparación.
Home Assistant Assist
- Plataformas:
- Home Assistant, web, iOS, Android
- Precio / licencia:
- Gratis / Apache-2.0
- Diferencia clave:
- Control por voz del hogar inteligente, no un control de despensa
Artículos sobre Home Assistant Assist (1)
- Home Assistant Assist Review: Local Voice Control and LLM AgentsActualizado 24 de octubre de 2026
Confirma el precio, la licencia y las plataformas actuales de cada app en su propia página.
Preguntas frecuentes
¿EverShelf es un LLM local?
No. Es un gestor de despensa escrito en PHP; su IA se delega en Gemini, OpenAI o un servidor Llama que gestionas tú, y según el sitio las funciones de despensa funcionan sin IA.
¿Cómo hago una copia de seguridad de mis datos?
Según las notas de versión, cada día se hace una copia como instantánea de la base de datos, pero se guarda dentro del volumen de datos, así que debes copiarla tú fuera del volumen.
¿Funciona con Home Assistant o con agentes de IA?
El repositorio enlaza una integración con Home Assistant (ha-evershelf) y un servidor MCP para agentes; PromptQuorum no probó ninguno de los dos.
¿Funciona en un móvil o una tablet?
Se abre en un navegador y se puede añadir a la pantalla de inicio, y la app de quiosco para Android está pensada para tablets de pared. El sitio y el README no enlazan ninguna ficha de App Store ni de Google Play.
¿Qué idiomas admite la interfaz?
El README enumera italiano, inglés, alemán, francés, español y chino, y la app se abre en el idioma de un enlace como ?lang=de; los colaboradores añaden un idioma traduciendo translations/en.json.
Veredicto
EverShelf es una forma gratuita y con actualizaciones frecuentes de controlar la despensa, las fechas de caducidad y las compras en un servidor que tú controlas, con IA opcional para reconocer productos, leer etiquetas de caducidad y escribir recetas. En contra, la instalación exige Docker y un archivo .env editado a mano, la IA funciona con Gemini u OpenAI salvo que configures tu propio servidor Llama, el proyecto tiene menos de un año y no se pudo comprobar ninguna de las afirmaciones sobre IA ni privacidad. Encaja con hogares que ya alojan sus servicios; quien busque una app con instalación de doble clic o un asistente de modelo de lenguaje debería mirar en otra parte.
Fuentes
- Sitio web de EverShelf — funciones, preguntas frecuentes y aviso de privacidad, revisados el 1 de noviembre de 2026.
- EverShelf en GitHub — README, releases, configuración de ejemplo, política de seguridad y actividad de commits, revisados el 1 de noviembre de 2026.
- Páginas de la wiki de EverShelf en el repositorio — funciones, instalación y proveedores de IA, revisadas el 1 de noviembre de 2026.
- README de la app de quiosco para Android de EverShelf — versión, nivel mínimo de Android y descarga, revisados el 1 de noviembre de 2026.