Una máquina que permanece encendida
Necesitas un servidor Linux Debian o Ubuntu, Node.js 22 o posterior y git. Un proxy inverso como Caddy solo hace falta para una dirección pública con HTTPS.
Documentos
Empezando
La instalación en seis comandos.
Ejecútalos en orden en un servidor Linux. Clonan el repositorio público, construyen la aplicación, crean el acceso e instalan el servicio permanente y su supervisor.
git clone https://github.com/haikostudio/belugabuildtool.git beluga cd beluga npm install npm run build node scripts/set-credentials.mjs sudo scripts/installer-services.sh
Beluga escucha después en 127.0.0.1:7070. Un proxy inverso como Caddy puede publicarlo en tu dominio con HTTPS.
El repositorio público
El repositorio público se clona por HTTPS sin invitación. El archivo ofrecido aquí contiene el mismo proyecto para quien prefiera una descarga directa.
Una herramienta de IA en tu servidor
Instala al menos una herramienta de línea de comandos compatible: Claude Code, Codex o Cursor. El asistente inicial muestra qué falta en la máquina.
Tus propias cuentas
Conecta Claude o Codex desde la interfaz, o añade una clave de Cursor. Varias cuentas del mismo motor pueden repartirse el trabajo según su disponibilidad.
Solución de problemas
cuando algo se rompe
Los tres fallos que surgen con más frecuencia, cada uno respondido en una línea.
El servicio comienza y luego se detiene.
Consulta su estado y sus registros con systemctl y journalctl para identificar la ruta, el usuario o la dependencia que lo bloquea.
La compilación se detiene en "tsc: no encontrado"
Reinstala con NODE_ENV=development npm install --include=dev y vuelve a ejecutar npm run build.
Ningún motor está listo
El asistente inicial indica si falta la herramienta o hay que volver a conectar la cuenta. Sigue el comando mostrado y regresa a la interfaz.
¿Listo para instalar?
Descarga el archivo o clona el repositorio público y sigue los seis comandos en orden.