purify-tuya
Purify-tuya es una PWA auto-alojada para controlar dispositivos Tuya (purificadores, deshumidificadores) vía red local sin nube. Usa FastAPI y React 19 con arquitectura de drivers extensible, automatizaciones basadas en umbrales y gestión de habitaciones.
Ficha actualizada 23 sept 2026, 22:18 · upstream 23 sept 2026, 21:46 · release v2.1.0
Qué es purify-tuya
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Purify-tuya es una plataforma auto-alojada para gestionar dispositivos Tuya directamente desde la red local, eliminando la dependencia de la nube. El sistema combina un backend en FastAPI con Python y un frontend React 19 como PWA instalable, permitiendo control offline y sincronización en tiempo real vía WebSocket.
La arquitectura utiliza drivers específicos para purificadores y deshumidificadores dentro de un sistema extensible por plugins. Incluye gestión de habitaciones, historial de métricas y notificaciones de eventos. El backend persiste datos en SQLite asíncrono y soporta una API REST v1 multi-dispositivo además de compatibilidad con la API legacy v0.
El despliegue requiere configuración manual de credenciales Tuya (DEVICE_ID, LOCAL_KEY) mediante variables de entorno o archivo .env. No incluye soporte nativo para Docker ni Compose, por lo que se recomienda usar systemd o Apache como proxy inverso en entornos de producción.
- Control local sin nube de dispositivos IoT
- Gestión centralizada de múltiples aparatos Tuya
- Automatización basada en umbrales ambientales
- Monitorización histórica de métricas por dispositivo
- Desarrollo y pruebas en modo simulación (mock)
- Arquitectura modular con drivers extensibles para hardware específico
- Sincronización bidireccional vía WebSocket en tiempo real
- Frontend PWA funcional sin conexión a internet
- Compatibilidad con API legacy v0 para integración gradual
- Base de datos SQLite asíncrona ligera
- Requiere configuración manual de credenciales Tuya (DEVICE_ID, LOCAL_KEY)
- No incluye contenedores Docker ni archivos Compose nativos
- Dependencia estricta de Python 3.13 o superior
- Gestión manual de persistencia SQLite sin backup automático incluido
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.
Despliegue recomendado mediante systemd o Apache con proxy inverso. Se debe configurar el archivo .env en backend/ con variables DEVICE_ID, DEVICE_IP y LOCAL_KEY obligatorias. Apache requiere módulos mod_proxy, mod_proxy_http y mod_proxy_wstunnel habilitados para el WebSocket. El frontend se compila con Vite antes de servir estático.
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.