Abyssan
Abyssan es un cliente gráfico auto-hospedable para visualizar y gestionar repositorios Git, con interfaz basada en DAG (Directed Acyclic Graph), staging visual y seguridad mediante token. Se ejecuta localmente sin necesidad de GitHub o GitLab.
Ficha actualizada 23 sept 2026, 1:55 · upstream 23 sept 2026, 1:52 · release abyssan1.0.0
Qué es Abyssan
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
<p>Abyssan es una herramienta de desarrollo Git que permite visualizar el flujo de trabajo del proyecto mediante un grafo de dependencias, preparar commits con visualización de cambios y ejecutar flujos de trabajo de forma segura desde el navegador.</p><p>Se diferencia de herramientas tradicionales como GitHub o GitLab al ser auto-hospedable, gratuito y no requerir una suscripción. Su enfoque se centra en la comprensión del estado del proyecto antes de realizar operaciones críticas como merges o rebase.</p><p>La arquitectura está diseñada para escalar desde entornos locales hasta múltiples proyectos, con un backend Node.js que opera repositorios locales mediante el módulo simple-git y una SPA React que muestra el DAG de dependencias entre commits.</p>
- Visualizar la historia de un proyecto Git en formato de grafo para entender relaciones entre ramas y commits
- Preparar commits con visualización inmediata de cambios (diff) antes de realizar operaciones críticas
- Entender el efecto de un merge o rebase antes de ejecutarlo, incluyendo conflictos estimados
- Auditoría de seguridad mediante token de instancia para proteger repositorios sensibles
- Gestión de múltiples proyectos en un solo entorno local sin necesidad de clonar repositorios externos
- Comprender el estado del proyecto (status) y cambios no commiteados con una interfaz intuitiva
- Interfaz basada en DAG que representa la historia del proyecto como un árbol jerárquico, facilitando la comprensión de dependencias entre commits
- Staging visual con preview inmediato de cambios antes de commitar, permitiendo revertir o ajustar el estado sin perder contexto
- Seguridad mediante token de instancia y validación de rutas, protegiendo repositorios sensibles contra accesos no autorizados
- Arquitectura monolítica en Node.js con simple-git como único módulo de gestión de repositorios, reduciendo dependencias externas
- Diseño orientado a la escalabilidad desde un entorno local hasta múltiples proyectos, con soporte para worktrees y forjas futuras
- Comunidad activa con documentación completa, plantillas de commit y modo aprendizaje que enseña el efecto de cada operación
- No soporta repositorios remotos externos (GitHub, GitLab) sin un backend externo; solo opera sobre repositorios locales dentro del proyecto
- La seguridad depende del token de instancia y no ofrece autenticación en segundo plano como GitHub o GitLab
- El modo aprendizaje es estático y no se adapta a los patrones de trabajo del equipo, por lo que puede ser poco efectivo para equipos grandes
- No soporta operaciones avanzadas como forjas (cherry-pick), rebase visualizado o merge conflicts complejos sin intervención manual
- La persistencia de cambios en modo staging es limitada y no se integra con un sistema de journaling persistente por defecto
- El grafo de dependencias es estático y no refleja el estado actual del proyecto, lo que puede generar confusiones si los commits cambian dinámicamente
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.
Abyssan se despliega mediante Docker Compose. Se recomienda ejecutar la API en un entorno aislado (container o VM) con permisos de lectura-escritura restringidos al directorio `PROJECTS_ROOT`. El frontend se ejecuta en el mismo contenedor para minimizar latencia. Para producción, se recomienda desplegar la API en un servidor dedicado y el frontend en un entorno separado (VPS o cloud), configurando los URLs VITE_API_URL y VITE_WS_URL correspondientes. Se debe implementar autenticación de tokens en producción y habilitar HTTPS. El proyecto está diseñado para escalar a múltiples proyectos, por lo que se recomienda usar Workspaces pnpm para gestionar el monorepo.
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.