Ctrl K
ComunidadGuías…
GITHUB · ANALIZADO

wine-cellar

Wine Cellar es una aplicación self-hosted para gestión de bodega de vinos en iOS, Android y web. Utiliza IA local (Ollama) y búsqueda web (SearXNG) sin suscripciones externas.

Ficha actualizada 26 sept 2026, 5:11 · upstream 26 sept 2026, 4:51 · release sin release detectada

Ver códigoProblemas y ayudaRepositorio ↗
00

Qué es wine-cellar

Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.

Wine Cellar es una aplicación self-hosted para gestión personal de bodega de vinos, disponible en iOS, Android y web mediante Expo. Permite almacenar precios reales de tiendas (priorizando Brasil), escanear etiquetas con visión por computadora local, gestionar cellar y wishlist sincronizados, realizar evaluaciones estructuradas de cata sin depender de terceros como Vivino, y monitorizar temperatura/humedad mediante sensores Tuya.

La arquitectura utiliza Express API con PostgreSQL, Ollama para modelos locales de IA (investigación web y lectura de etiquetas), SearXNG para búsqueda en tiendas y productores, Resend para autenticación sin contraseña mediante códigos por email, y Frankfurter para conversión de divisas. Todo el stack corre en hardware propio sin suscripciones de IA ni backend externo.

El despliegue se realiza con Docker Compose (sin Dockerfile nativo), requiriendo Ollama instalado en el host fuera del contenedor para aprovechar GPU. El acceso externo se recomienda mediante Tailscale Serve o reverse proxy propio, evitando exponer puertos públicamente. Las migraciones de base de datos son automáticas al iniciar.

CASOS DE USO
  • Gestión completa de bodega personal con cellar y wishlist sincronizados entre dispositivos
  • Búsqueda de vinos mediante IA local que consulta tiendas web y páginas de productores sin suscripción
  • Escaneo de etiquetas de botellas usando modelo de visión local para identificación automática
  • Seguimiento de precios en tiendas reales con conversión a BRL desde otras divisas
  • Evaluaciones estructuradas de cata con campos validados (intensidad, equilibrio, complejidad, persistencia)
  • Monitorización en tiempo real de temperatura y humedad de la bodega vía sensores Tuya
PUNTOS DESTACADOS
  • Todo self-hosted: investigación IA y lectura de etiquetas corren en hardware propio sin suscripciones
  • Datos propios: no hay nube para procesamiento de IA, credenciales Tuya cifradas en reposo
  • Escaneo de etiquetas con modelo local (qwen3.5:9b) que incluye capacidades de visión
  • Autenticación passwordless mediante códigos únicos por email vía Resend
  • Integración IoT con Tuya Cloud OpenAPI para lectura de sensores climáticos
  • Export/Import completo de colección como archivo único para migración o backup
PRECAUCIONES
  • Ollama debe instalarse en el host fuera del contenedor Docker para usar GPU nativamente
  • La investigación web por vino tarda 1-2 minutos en segundo plano dependiendo del hardware
  • No incluye Dockerfile, solo docker-compose.yml para despliegue
  • Acceso externo requiere Tailscale Serve o reverse proxy propio sin puertos públicos
  • Precios priorizados en tiendas brasileñas; conversión automática a BRL desde otras divisas
VISUAL

Capturas del proyecto

Imágenes reales detectadas en la documentación del repositorio.

Wine Cellar app demoWine Cellar app icon
01

Perfil de infraestructura

Estimación inicial derivada del repositorio y de los servicios detectados.

CPU4 vCPUrecomendación inicial
MEMORIA8 GBRAM estimada
DISCO20 GBalmacenamiento base
COMPLEJIDADmediumnivel de operación
02

Despliegue detectado

Qué señales reales de instalación hemos encontrado.

Listo para automatizar

Requiere Ollama instalado en el host (fuera Docker) con modelo qwen3.5:9b (6.6 GB). Usar Tailscale Serve o reverse proxy propio para acceso externo sin exponer puertos públicamente. Backup conjunto de volúmenes pgdata y uploads. Actualización con git pull + docker compose up --build --remove-orphans; migraciones automáticas al inicio. Variables de entorno necesarias: JWT_ACCESS_SECRET, JWT_REFRESH_SECRET, ENCRYPTION_KEY, RESEND_API_KEY, EMAIL_FROM.

✓Dockerfile
✓Compose
✓One-click
03

Stack y dependencias

Componentes inferidos a partir de manifests, configuración y documentación.

FRAMEWORKS
ReactNode.js
SERVICIOS
PostgreSQL
BASES DE DATOS
PostgreSQL
PUERTOS
3000
05

Puede sustituir a

Relaciones detectadas por el análisis del repositorio y su categoría.

06

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.