garde-manger
Garde-manger es una aplicación open source para gestionar la despensa compartida del hogar: inventario, fechas de caducidad, lista de compras, escaneo de recibos/frigorífico y recetas con ingredientes disponibles.
Ficha actualizada 24 sept 2026, 8:36 · upstream 24 sept 2026, 8:31 · release 1.0.0-rc.1
Qué es garde-manger
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Garde-manger permite a los hogares gestionar el inventario alimentario compartido, controlando fechas de caducidad, generando listas de compras y creando recetas basadas en lo que queda. La solución ofrece dos modalidades: una versión alojada (hosted) gratuita para lo esencial con suscripción para IA, y una versión autoalojada (self-hosted) donde la API corre localmente sin límites de tasa en el uso de inteligencia artificial.
La arquitectura técnica se basa en Next.js y Node.js para el backend (AdonisJS), PostgreSQL como base de datos y Expo para la aplicación móvil. El despliegue recomendado utiliza Docker Compose v2, con separación clara entre volúmenes de datos (pgdata) y almacenamiento de archivos (storage). La configuración de IA es flexible, permitiendo proveedores externos como Gemini o OpenAI, o modelos locales vía Ollama sin que salgan datos del hogar.
La aplicación móvil está disponible para Android mediante APK directo, mientras que en iOS se accede temporalmente a través de Expo Go. El sistema incluye soporte para autenticación segura con mejor-auth y opciones opcionales como PocketID. Las actualizaciones son automáticas pero requieren backup previo debido a las migraciones no reversibles.
- Gestión de inventario compartido en múltiples dispositivos móviles dentro del hogar
- Detección de productos próximos a caducar para evitar desperdicios alimentarios
- Generación automática de recetas basadas en los ingredientes disponibles actualmente
- Escaneo visual de recibos y contenido del frigorífico mediante IA integrada
- Licencia MIT y código abierto, permitiendo inspección y modificación completa del software
- Uso de inteligencia artificial sin límites de tasa en la versión autoalojada
- Compatibilidad con modelos locales como Ollama para mantener los datos privados en el hogar
- Arquitectura modular con separación clara entre dominio, aplicación e infraestructura
- Requiere Docker Compose v2 y conocimientos básicos de contenedores para el despliegue
- La aplicación móvil en iOS solo está disponible temporalmente a través de Expo Go
- Las migraciones de base de datos son automáticas y no reversibles, obligando a backup previo
- El escaneo de IA requiere configuración manual de claves API o instalación local de Ollama
Capturas del proyecto
Imágenes reales detectadas en la documentación del repositorio.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Desplegar en red local segura o detrás de proxy HTTPS (ej. Caddy) para proteger sesiones. Configurar variables de entorno .env con credenciales generadas aleatoriamente y permisos restrictivos (chmod 600). Antes de actualizar, realizar backup manual de volúmenes pgdata y storage. Asegurar que CORS_ORIGIN incluya los orígenes móviles (exp://, gardemanger://). Para producción, evitar usar localhost en APP_URL y NETWORK_URL.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.