Une machine qui reste allumée
Il faut un serveur Linux Debian ou Ubuntu, Node.js 22 ou plus et git. Un reverse-proxy comme Caddy est nécessaire seulement si vous voulez une adresse publique en HTTPS.
Docs
Démarrage
L'installation en six commandes
Recopiez-les dans l’ordre sur un serveur Linux. Elles clonent le dépôt public, construisent l’application, créent l’accès puis installent le service permanent et son surveillant.
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 écoute alors en local sur 127.0.0.1:7070. Un reverse-proxy comme Caddy peut ensuite l’exposer sur votre domaine avec HTTPS.
Le dépôt public
Le dépôt public se clone par HTTPS, sans invitation. L’archive proposée sur cette page contient le même projet pour qui préfère un téléchargement direct.
Un outil IA sur votre serveur
Installez au moins un des outils en ligne de commande pris en charge : Claude Code, Codex ou Cursor. L’assistant de démarrage montre ce qui manque sur la machine.
Vos propres comptes
Connectez Claude ou Codex depuis l’interface, ou ajoutez une clé Cursor. Plusieurs comptes d’un même moteur peuvent ensuite partager le travail selon leur disponibilité.
Dépannage
Quand ça coince
Les trois pannes qui reviennent le plus souvent, et leur réponse en une ligne.
Le service démarre puis s'arrête
Relisez son état et ses journaux avec systemctl et journalctl pour identifier le chemin, l’utilisateur ou la dépendance qui bloque.
La construction s'arrête sur « tsc: not found »
Réinstallez les dépendances avec NODE_ENV=development npm install --include=dev, puis relancez npm run build.
Aucun moteur n’est prêt
L’assistant de démarrage indique si l’outil manque ou si le compte doit être reconnecté. Suivez la commande affichée, puis revenez dans l’interface.
Prêt à installer ?
Téléchargez l’archive ou clonez le dépôt public, puis suivez les six commandes dans l’ordre.