Installation

Miravo s’exécute en tant que processus unique. Choisissez la méthode adaptée à votre environnement.

Docker (recommandé)

Téléchargez et exécutez l’image multi-architecture (linux/amd64 et linux/arm64). Le port 1883 est le broker MQTT et le port 8080 est l’API admin et la console web :

docker run --rm -p 1883:1883 -p 8080:8080 amineamaach/miravo:latest

L’image est également disponible sur GitHub Container Registry :

docker run --rm -p 1883:1883 -p 8080:8080 ghcr.io/amine-amaach/miravo:latest

Épinglez une version spécifique :

docker run --rm -p 1883:1883 -p 8080:8080 amineamaach/miravo:0.3.0

bunx

Nécessite Bun installé localement :

Exécution directe

bunx miravo start

Install globale

bun install -g miravo
miravo start

Binaire autonome

Téléchargez un binaire précompilé depuis la page GitHub Releases :

Plateforme	Architecture	Fichier
Linux	x64	miravo-linux-x64.tar.gz
Linux	arm64	miravo-linux-arm64.tar.gz
macOS	x64	miravo-darwin-x64.tar.gz
macOS	arm64	miravo-darwin-arm64.tar.gz
Windows	x64	miravo-windows-x64.zip

tar xzf miravo-linux-x64.tar.gz
chmod +x miravo
./miravo start

Le binaire autonome intègre tout le contenu intégré. Aucune dépendance d’exécution requise.

Depuis les sources

git clone https://github.com/amine-amaach/miravo.git
cd miravo
bun install
bun run packages/cli/src/index.ts start

Vérification

Après le démarrage, confirmez que les données circulent :

Vérification de santé admin :

curl http://127.0.0.1:8080/healthz

S’abonner aux données MQTT :

mosquitto_sub -h 127.0.0.1 -t '#' -v