wisp
Marco digital DIY alimentado por batería usando displays e-Paper Waveshare y ESP32. Monorepo unificado con backend Go, frontend Vue 3 y firmware PlatformIO. Soporta Docker Compose.
Ficha actualizada 25 sept 2026, 7:21 · upstream 25 sept 2026, 7:09 · release v0.3.1
Qué es wisp
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
WiSP es una solución todo-en-uno para crear marcos digitales personalizados con displays e-Paper de Waveshare y microcontroladores ESP32. El repositorio integra tres componentes principales: un backend en Go que indexa fotos, sirve contenido binario al firmware y expone una API JSON; un frontend Vue 3 SPA para gestión de catálogos; y firmware ESP32 compilado con PlatformIO/Arduino C++.
El proyecto utiliza SQLite como base de datos por defecto y soporta tanto fotos locales como HTTP catalogs que permiten visualizar contenido externo como dashboards, arte generado por IA o mapas meteorológicos. La arquitectura está diseñada para despliegue en entorno autoalojado con soporte Docker Compose, aunque no incluye Dockerfile nativo.
Es importante destacar que el proyecto se encuentra en fase experimental y work in progress. Las APIs, formatos de configuración y objetivos de hardware pueden cambiar sin aviso. El escaneo de fotos requiere ejecución manual mediante make scan al añadir o eliminar imágenes, ya que el directorio no se monitoriza en tiempo real.
- Crear marcos digitales DIY alimentados por batería con displays e-Paper Waveshare
- Visualizar catálogos de fotos locales o contenido externo vía HTTP catalogs
- Gestionar múltiples displays e-Paper desde una única instancia del backend Go
- Integrar dashboards, arte generado por IA o mapas meteorológicos como contenido visual
- Despliegue autoalojado con firmware ESP32 que se registra vía mDNS (wisp.local)
- Configuración inicial mediante SoftAP para establecer credenciales Wi-Fi y URL API
- Monorepo unificado que contiene backend Go, frontend Vue 3 y firmware ESP32 en un solo repositorio
- Soporte nativo para HTTP catalogs que permiten visualizar contenido externo sin almacenamiento local
- Configuración flexible vía YAML con soporte para múltiples displays y definiciones de modelos
- Firmware ESP32 con mDNS (wisp.local) y SoftAP inicial para configuración sin cableado
- CI/CD separado por componentes con workflows independientes para API, frontend y firmware
- Generación automática de config files, .env y fotos de ejemplo mediante make dev-setup
- Proyecto experimental en fase work in progress sin garantías de estabilidad a largo plazo
- Escaneo manual de fotos requerido (no hay watch en tiempo real del directorio)
- APIs, formatos de configuración y objetivos de hardware pueden cambiar sin aviso previo
- No incluye Dockerfile nativo, requiere Docker Compose para orquestación
- Base de datos SQLite por defecto puede no ser adecuada para entornos de producción escalables
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.
Ejecutar make dev-setup para generar config files, .env y fotos de ejemplo. Usar make up para iniciar el stack en los puertos 8080 (frontend) y 9002 (API). Re-ejecutar make scan cada vez que se añadan o eliminen fotos. Configurar API_BASE_URL en .env con la IP LAN del servidor. Para firmware, configurar credenciales Wi-Fi y URL API vía SoftAP en primer arranque. El dispositivo se registra como wisp.local vía mDNS tras conectarse a Wi-Fi.
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.