spool-control
spool-control es una aplicación web en Python para gestionar inventario de filamentos de impresión 3D, con integración de pesaje automático, etiquetas térmicas y API para Home Assistant.
Ficha actualizada 28 sept 2026, 2:44 · upstream 28 sept 2026, 2:16 · release v1.39.2
Qué es spool-control
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Es un sistema robusto basado en Flask y SQLite diseñado para el control de stock de materiales de impresión 3D. Permite registrar filamentos, gestionar carretes individuales con historial de pesaje (bruto - tara) y generar etiquetas PDF o térmicas con códigos QR únicos. La interfaz soporta multilenguaje (PT/EN/ES) y ofrece roles de acceso diferenciados entre administrador y visualizador.
El sistema incluye integraciones nativas para Home Assistant mediante REST API read-only y soporte directo para impresoras térmicas Niimbot vía Web Bluetooth desde el navegador. Cuenta con autenticación segura, 2FA opcional (TOTP) y copias de seguridad automáticas rotativas de 7 días.
Se despliega fácilmente en entornos Proxmox LXC o servidores Debian 12 usando systemd y Traefik para HTTPS. Ofrece endpoints API para estaciones de pesaje automatizadas, permitiendo flujos de trabajo industriales sin intervención manual constante.
- Control de inventario de filamentos con alertas de stock bajo
- Integración con estaciones de pesaje automático vía API
- Visualización de stock en Home Assistant mediante REST API
- Impresión directa de etiquetas térmicas Niimbot desde navegador
- Generación de informes detallados por material y ubicación
- Base de datos SQLite optimizada para lectura con modo WAL
- Soporte nativo para impresión térmica Web Bluetooth en Niimbot
- Integración read-only con Home Assistant sin MQTT
- Autenticación robusta con 2FA TOTP y gestión de claves API
- Copias de seguridad automáticas con rotación semanal
- Base de datos SQLite puede tener limitaciones de concurrencia en entornos muy concurrentes
- La impresión térmica requiere soporte Web Bluetooth del navegador cliente
- Sin dominio público, el acceso QR se limita a la red local (IP interna)
- El 2FA TOTP requiere sincronización precisa de reloj del servidor (NTP)
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 en Proxmox LXC con Debian 12. Configurar Traefik con HTTPS y Let's Encrypt para habilitar SECURE_COOKIES. Asegurar dominio público para que los códigos QR funcionen globalmente. Ejecutar seed_brands.py tras el primer acceso para cargar logotipos. Gestionar copias de seguridad externas manualmente si no se usa la rotación automática.
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.