3. Déploiement & Infrastructure

ECHO est conçu pour transformer une machine standard en un serveur d'intelligence souveraine. Le scénario nominal consiste à utiliser un poste Windows 11 Pro comme hôte matériel, exécutant une Machine Virtuelle Ubuntu 24.04 isolée via Hyper-V. La totalité de la pile Docker ECHO s'exécute dans cette VM, garantissant une étanchéité totale entre les outils quotidiens de l'utilisateur et son infrastructure IA personnelle.

Voie A - Hyper-V (Production Souveraine)

Le scénario Hyper-V est le plus abouti. Il utilise le script PowerShell install-hyperv.ps1 exécuté depuis le poste Windows, lequel orchestre la création et le provisioning automatique d'une VM Ubuntu fraîche via le mécanisme cloud-init.

Phase 1 - Assemblage et injection (hôte Windows)

install-hyperv.ps1 (version 5.147.43) agit comme assembleur. Il crée une archive ZIP pointant par défaut sur la branche main du projet (hors .git, .venv, node_modules), génère un disque dur virtuel CIDATA de 100 Mo contenant les fichiers user-data et meta-data cloud-init, puis crée la VM Hyper-V de Génération 2 (avec 8 Go de RAM alloués et un VHDX de 70 Go dynamiques, Secure Boot désactivé) et le disque Seed attaché.

Phase 2 - Provisioning automatisé (VM Linux)

Au premier démarrage, l'installateur Ubuntu (Subiquity) détecte le disque CIDATA et exécute les instructions cloud-init : installation de Docker, Docker Compose v2, jq, yq, git et unzip. L'archive ZIP est extraite dans /opt/ECHO/source, puis sync-echo.sh --local-only est lancé immédiatement pour distribuer les fichiers.

Phase 3 - Synchronisation des sources (sync-echo.sh)

Ce script est le distributeur du framework. Il copie les fichiers sources vers leur destination définitive dans /opt/ECHO/ selon la cartographie suivante :

Le script effectue également une normalisation des fins de lignes (CRLF → LF) et supprime les BOM UTF-8, puis crée des liens symboliques dans /usr/local/bin/ pour que toutes les commandes ECHO soient accessibles globalement (ex. update-echo au lieu de /opt/ECHO/echo-scripts/update-echo.sh).

Phase 4 - Orchestration Docker (install-stack.sh)

Ce script orchestre le démarrage de la pile applicative via le fichier de configuration centralisé stack-echo.yml, . Il sécurise également l'hôte en appliquant une politique Autosafety de rotation des logs Docker (max-size 50m). Il centralise les secrets et variables dans /opt/ECHO/.env (incluant la génération automatique de ECHO_SSO_SECRET), calcule dynamiquement les origines CORS autorisées (ECHO_DETECTED_ORIGINS), puis lève les services.

Une fois les conteneurs actifs, config-owui.sh exécute l'initialisation : il injecte l'Arsenal (Pipes, Filtres, Outils, Actions) dans l'API d'Open WebUI, et importe automatiquement la configuration globale depuis webui-settings.json. Ce fichier configure dynamiquement le modèle par défaut (pipe_engine), configure les moteurs RAG, connecte les API STT et TTS locales (ex: http://echo-tts-worker:7996/v1), et désactive l'authentification native de WebUI pour déléguer la gestion à Antigravity.

Voie B - Linux Natif (Serveur Dédié)

curl -fsSL https://raw.githubusercontent.com/Wilfried-Barnavon-Perso/echo-framework/main/install-linux.sh | sudo bash

# Ou sur une branche spécifique :
sudo bash <(curl -fsSL https://raw.githubusercontent.com/Wilfried-Barnavon-Perso/echo-framework/main/install-linux.sh) --branch dev

install-linux.sh est idempotent : si ECHO est déjà installé, une seconde exécution effectue une mise à jour propre. Il installe Docker, Docker Compose v2, jq, yq, git, chrony, puis clone le dépôt dans /opt/ECHO/source et enchaîne sync-echo.sh et install-stack.sh.

Voie C - WSL2 (Développement)

curl -fsSL https://raw.githubusercontent.com/Wilfried-Barnavon-Perso/echo-framework/main/install-wsl2.sh | sudo bash

Spécificités gérées par install-wsl2.sh :

• Détection systemd : si /etc/wsl.conf déclare systemd=true, Docker est activé comme service permanent. Sinon, fallback sur service docker start.
• Accès double : l'interface est accessible depuis WSL2 (http://<IP-WSL>:3000) et depuis l'hôte Windows (http://localhost:3000) grâce au port forwarding automatique de WSL2.
• chrony n'est pas installé : la synchronisation de l'heure est assurée par l'hôte Windows.

[boot]
systemd=true

Comparatif des trois méthodes

Cycle de vie et maintenance

Une fois déployée, l'infrastructure ECHO se gère via des commandes globales disponibles partout dans le shell Linux :

Quickstart depuis sources locales

# Depuis la racine du dépôt git ECHO cloné localement :
sudo bash 00-echo-scripts/sync-echo.sh --local-only
sudo bash 00-echo-scripts/install-stack.sh

# Interface disponible sur http://localhost:3000