trug
Lista de compras compartida auto-alojada para un hogar, PWA offline-first con passkey sign-in, MCP + voice-ring capture, tema Catppuccin. Un docker compose up.
Ficha actualizada 27 sept 2026, 10:36 · upstream 27 sept 2026, 10:12 · release v0.5.0
Qué es trug
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Trug es una aplicación web progresiva (PWA) diseñada específicamente para facilitar las compras semanales de un hogar único. La arquitectura se basa en un solo archivo SQLite detrás de un servidor FastAPI, eliminando la necesidad de cuentas en la nube, suscripciones o servicios de terceros. El sistema prioriza el rendimiento donde importa: permite leer y marcar productos sin conexión mediante optimismo, autenticación con passkeys para evitar contraseñas en tiendas, y captura de voz que añade directamente items a la lista.
La aplicación está diseñada bajo una filosofía minimalista que rechaza deliberadamente características como planificación de comidas, inventario de despensa, seguimiento de precios o jerarquías administrativas. Cada funcionalidad se evalúa contra el criterio: "¿hace esto más rápida la compra del sábado?". El proyecto utiliza temas Catppuccin (Mocha, Latte) e incluye integración con asistentes de IA mediante MCP sin necesidad de claves LLM adicionales gracias a su arquitectura optimizada.
El despliegue es sencillo mediante Docker Compose en una sola línea, o scripts automáticos que verifican dependencias. Soporta instalación en Raspberry Pi, NAS o servidores domésticos. Incluye integración con Claude AI vía MCP para añadir ingredientes automáticamente desde recetas, y captura de voz desde anillos Pebble que añade items directamente a la lista.
- Lista de compras compartida offline-first para múltiples dispositivos en el hogar
- Integración con Claude AI vía MCP para añadir ingredientes automáticamente desde recetas
- Captura de voz desde anillos Pebble que añade items directamente a la lista
- Autenticación sin contraseñas mediante passkeys para acceso rápido en tiendas
- Despliegue auto-alojado en Raspberry Pi, NAS o servidores domésticos con Docker Compose
- Compartir lista mediante QR y enlaces seguros dentro de la misma red WiFi
- Arquitectura offline-first permite uso sin conexión en tiendas con señal limitada
- Base de datos SQLite única facilita copias de seguridad sencillas (un comando)
- Autenticación por passkeys elimina necesidad de contraseñas o formularios de registro
- Integración MCP nativa con Claude AI para gestión inteligente de listas
- Tema Catppuccin con múltiples esquemas de color preconfigurados
- Despliegue en una sola línea con script de instalación automático
- Soporta solo un hogar por instancia (sin multi-tenencia)
- No incluye planificación de comidas ni inventario de despensa
- Requiere HTTPS o localhost para crear passkeys en dispositivos móviles
- Solo disponible como PWA instalable, sin aplicaciones nativas
- Sin seguimiento de precios, presupuestos o programas de fidelidad
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.
Requiere Docker Compose v2 y curl preinstalados. El script de instalación verifica dependencias automáticamente. Para acceso remoto, usar trug share dentro de la misma red WiFi o configurar dominio HTTPS con trug set-origin. Las copias de seguridad son un solo archivo SQLite. En Railway funciona en plan Hobby (~$5/mes). Necesita 2 núcleos CPU y 2GB RAM mínimo. El comando docker compose up -d debe ejecutarse después de pull para evitar compilación desde fuente.
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.