huell
Plataforma auto-alojada para documentación conectada a Git que genera sitios estáticos con Astro Starlight, dashboard Next.js y despliegue automático al push.
Ficha actualizada 28 sept 2026, 2:42 · upstream 28 sept 2026, 2:32 · release sin release detectada
Qué es huell
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
Huell es una plataforma de documentación auto-alojada diseñada para organizaciones que desean controlar su infraestructura sin depender de proveedores externos. Conecta repositorios GitHub o acepta archivos docs.zip para generar sitios documentales limpios y buscables, con despliegue automático al hacer push a Git.
La arquitectura consta de cuatro componentes principales gestionados mediante Docker Compose: un proxy inverso Caddy, un dashboard en Next.js, un worker de construcción que ejecuta Astro Starlight para cada proyecto modificado, y salida estática servida directamente desde el sistema de archivos. Utiliza bases de datos como PostgreSQL, Redis y MongoDB según configuración, aunque la documentación técnica menciona SQLite para metadatos.
Incluye CLI huellup para validación local y preview, servidor MCP para agentes de IA que escriben documentación válida contra el esquema real, gestión de roles por proyecto (owner/editor/viewer), subdominios automáticos con HTTPS y componentes de contenido como LaTeX, modo oscuro y llamadas a la acción.
- Auto-alojar documentación técnica para equipos pequeños o empresas sin contrato con proveedores
- Generar sitios documentales automáticamente al push a repositorios GitHub existentes
- Integrar agentes de IA mediante MCP server para escribir y validar documentación automáticamente
- Migrar documentación existente desde docs.json + MDX sin reestructurar el contenido
- Despliegue push-to-deploy automático con reconstrucción al push a Git
- Sin vendor lock-in: datos y infraestructura propiedad del usuario
- CLI huellup para validación local, preview y generación de sitios documentales
- Servidor MCP integrado para que agentes de IA escriban documentación válida contra el esquema real
- Astro Starlight con componentes predefinidos (Note, Tip, Warning, Card, Steps, Tabs)
- Requiere infraestructura propia: Linux server, Docker + Docker Compose plugin y dominio con DNS controlado
- Complejidad HIGH según análisis técnico: requiere 4 núcleos CPU, 4096 MB RAM y 30 GB disco
- No tiene Dockerfile nativo, solo Docker Compose para orquestación
- Un instancia por organización: no es multi-tenant compartido
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 Linux server con Docker + plugin Docker Compose y dominio con DNS controlado. Clonar repositorio y ejecutar setup.sh. Verificar configuración de bases de datos (PostgreSQL, Redis, MongoDB) según análisis técnico. Asegurar 4 núcleos CPU, 4096 MB RAM y 30 GB disco mínimo. Para servidores sin IP pública, usar guía de tunnel deployment.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
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.