STLVault
STLVault es una aplicación web autoalojada diseñada para gestionar colecciones de modelos 3D destinados a impresión 3D. Proporciona una interfaz moderna para organizar archivos STL, STEP y 3MF mediante carpetas anidadas, etiquetas y grupos de impresión.
Ficha actualizada 27 sept 2026, 21:39 · upstream 27 sept 2026, 21:31 · release v0.8.0
Qué es STLVault
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
STLVault actúa como una biblioteca centralizada para entusiastas del modelado 3D que buscan mantener sus archivos ordenados y accesibles. La aplicación separa el frontend (React con Vite) del backend (Python con FastAPI), permitiendo una arquitectura escalable dentro de contenedores Docker. El sistema utiliza SQLite para persistir metadatos, etiquetas y la estructura de carpetas, mientras que los archivos 3D se almacenan en volúmenes externos mapeados al sistema de archivos local.
La interfaz web permite previsualizar modelos directamente en el navegador sin necesidad de software adicional, facilitando la inspección rápida antes de enviarlos a una impresora. Funcionalidades clave incluyen la gestión de manuales en formato Markdown, búsqueda global y acciones por lotes para mover o eliminar archivos. La aplicación está orientada al despliegue autoalojado, con soporte para integración en herramientas como Portainer mediante Docker Compose.
- Gestión centralizada de modelos 3D importados desde sitios web externos (Printables, Makerworld).
- Organización jerárquica de archivos mediante carpetas anidadas y grupos de impresión.
- Previsualización rápida de geometría 3D en el navegador antes del corte (slicing).
- Gestión de metadatos con etiquetas y descripciones para filtrado avanzado.
- Visor 3D integrado con soporte para múltiples formatos (STL, STEP, 3MF) y controles orbitales.
- Arquitectura contenerizada simplificada mediante Docker Compose con imágenes precompiladas disponibles.
- Capacidad de importación directa desde URLs externas con selección granular de archivos.
- Interfaz moderna construida con React TypeScript y Vite para un rendimiento optimizado.
- El proyecto se encuentra actualmente en estado Beta, por lo que puede haber cambios en la interfaz o funcionalidad.
- La base de datos utiliza SQLite, lo que podría limitar el rendimiento en colecciones extremadamente grandes.
- No hay documentación detallada sobre la configuración avanzada del backend más allá de las variables de entorno básicas.
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.
Recomendado usar Docker Compose con volúmenes mapeados para persistencia de datos y archivos. Es crucial no modificar los paths definidos en el archivo docker-compose.yml relativos a /app/uploads, /app/data y /app/manuals. Asegurar que el puerto 8999 esté disponible en la red local o configurar correctamente las variables de entorno APP_URL y API_URL para accesos externos.
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.