Configuración y descarga
Instalar KatanA
Use gestores de paquetes para la configuración más rápida o descargas directas desde GitHub Releases.
Rutas de instalación para macOS, Windows x86_64 y Linux x86_64.
Esta página se mantiene sincronizada con el repositorio para asegurar la consistencia con los últimos artefactos de distribución.
- 01
Soporte para Homebrew y Winget
- 02
Descargas directas disponibles
- 03
Notas por plataforma incluidas
Soporte actual
macOS / Windows x86_64 / Linux x86_64
Incluye Homebrew y DMG para macOS, Winget y MSI para Windows, y Homebrew y tar.gz para Linux x86_64.
macOS
macOS + Homebrew
Vía recomendada para la configuración más rápida en macOS.
- Método preferido según el README oficial.
- Listo para usar inmediatamente tras la instalación.
brew tap HiroyukiFuruno/KatanA && brew install --cask katana-desktopDescarga manual en macOS
- Descargue el último `KatanA-Desktop-x.y.z.dmg` de GitHub Releases.
- Mueva `KatanA Desktop.app` a su carpeta de Aplicaciones.
- Ejecute el comando de Gatekeeper si es necesario antes del primer inicio.
- En macOS Sequoia (15.x), esto puede ser necesario para builds no notarizados. Alternativamente, permítalo en Ajustes del Sistema > Privacidad y seguridad.
xattr -cr /Applications/KatanA\ Desktop.appWindows x86_64
Winget es el camino más rápido en Windows. MSI también disponible en GitHub Releases.
- Instale vía Winget o descargue `KatanA-windows-x86_64.msi` de GitHub Releases.
- Doble clic para instalar.
- Los accesos directos al Menú Inicio y Escritorio se crean automáticamente.
winget install HiroyukiFuruno.katana-desktopLinux x86_64
Se recomienda Homebrew si está disponible. tar.gz también disponible en GitHub.
- Instale vía Homebrew o descargue `KatanA-linux-x86_64.tar.gz` de GitHub Releases.
- Extraiga el archivo.
- Ejecute el binario directamente.
brew tap HiroyukiFuruno/KatanA && brew install katana-desktopActualización
- KatanA ofrece una función de auto-actualización integrada.
- En macOS, use el botón "Update & Restart" dentro de la aplicación.
- En Windows/Linux, el diálogo de actualización enlaza directamente a la última versión.
- Si se instaló vía Homebrew en macOS, la primera actualización desvincula la gestión de Homebrew para evitar conflictos.
Configuración opcional de diagramas
Solo PlantUML puede requerir una herramienta adicional.
Mermaid
Sin configuración extra
Los diagramas Mermaid, incluidos los diagramas de secuencia ZenUML, se renderizan en el flujo actual del documento.
PlantUML
Instalar Java Runtime
Ejecute `brew install openjdk@25` y descargue `plantuml.jar` al abrir un documento PlantUML por primera vez.
Draw.io
Sin configuración necesaria
Los diagramas de Draw.io funcionan de forma nativa en el flujo actual.
despues de instalar
Despues de instalar (3 comprobaciones)
- Abrir workspace: verificar README y specs en el arbol.
- Confirmar diagramas: abrir Mermaid, incluido ZenUML, o PlantUML y validar renderizado.
- Revisar updates: ejecutar una comprobacion de update en la app.
soporte
FAQ
PlantUML no renderiza
Instala Java runtime y permite descargar plantuml.jar.
macOS bloquea la app
Usa Open Anyway en Privacy & Security o ejecuta xattr una vez.