Démarrer le lanceur de bureau¶

La plupart des utilisateurs n'ont pas besoin du lanceur

Adaptive Learner fonctionne directement dans le navigateur, sans installation, sans Docker, sans lanceur : astrapi69.github.io/adaptive-learner. Le lanceur de bureau n'est utile que si tu veux héberger l'application toi-même ou exécuter localement des fonctionnalités du backend (mode serveur, synchronisation locale).

Le lanceur de bureau est le moyen le plus simple d'exécuter Adaptive Learner avec son propre backend sur ta propre machine. C'est une petite fenêtre qui s'occupe de tout le reste pour toi : elle vérifie que Docker est en cours d'exécution, télécharge et construit l'image de l'application au premier démarrage (une seule fois, 5-10 minutes c'est normal), démarre les conteneurs, puis ouvre l'application dans ton navigateur à l'adresse http://localhost:8501. Depuis la même fenêtre, tu peux aussi arrêter l'application, changer le port ou tout désinstaller.

Le port est 8501 par défaut et peut être changé dans la fenêtre du lanceur ; s'il est occupé, le lanceur se rabat sur un port libre.

Qui peut accéder à l'application¶

Par défaut, l'application n'est accessible que depuis cet ordinateur (127.0.0.1). C'est voulu : elle n'a pas d'authentification et elle contient vos clés de fournisseurs d'IA. Visible sur le réseau, n'importe quel appareil du même réseau - un LAN d'entreprise, le wifi d'un hôtel ou d'une conférence - pourrait tout simplement l'ouvrir et l'utiliser.

Y accéder depuis un autre appareil, par exemple votre téléphone sur votre propre wifi, reste possible mais devient un choix délibéré : définissez ADAPTIVE_LEARNER_BIND_ADDRESS=0.0.0.0 dans le fichier .env. Ne le faites que sur un réseau de confiance, et gardez à l'esprit que toute personne s'y trouvant aura alors le même accès que vous.

Prérequis : Docker - le lanceur le vérifie lui-même¶

Le lanceur nécessite un Docker en cours d'exécution, car l'application elle-même fonctionne comme un groupe de conteneurs. Tu n'as rien à vérifier manuellement : au démarrage, le lanceur contrôle lui-même si Docker est installé et en cours d'exécution, trouve aussi un Docker qui tourne sous un contexte Docker différent (comme Docker Desktop pour Linux ou Docker rootless), et affiche un message clair avec une solution lorsque quelque chose manque. Si Docker n'est pas encore installé du tout : Installer Docker Desktop.

Les messages du lanceur et ce qu'ils signifient :

Message	Signification	Solution
"Docker n'est pas installé (docker absent du PATH)."	La commande `docker` est introuvable.	Installer Docker Desktop. Le lanceur affiche directement le lien d'installation.
"Docker est installé mais n'est pas démarré." ou "Docker n'est pas en cours d'exécution. Contexte vérifié '...' (...) : ..."	Le service Docker ne tourne pas en ce moment ; la forme détaillée nomme le contexte sondé, le socket et l'erreur d'origine de Docker.	Clique sur le bouton "Démarrer Docker" dans le lanceur (Linux) ou ouvre Docker Desktop (macOS/Windows), puis "Réessayer".
"Docker est installé, mais tu n'as pas la permission."	Ton utilisateur n'est pas dans le groupe `docker` (Linux).	Le lanceur affiche la commande exacte ; déconnecte-toi puis reconnecte-toi ensuite.
"Docker ne répond pas."	Docker est très probablement encore en train de démarrer (typique juste après l'ouverture de Docker Desktop).	Attends un instant, puis "Réessayer".
"Docker fonctionne via le contexte '...' - le contexte actif était injoignable, le lanceur s'est connecté automatiquement."	Purement informatif : Docker tournait sous un autre contexte, le lanceur l'a trouvé et l'utilise.	Rien à faire.
"Docker Desktop est installé mais absent du PATH."	L'application Docker Desktop est présente, mais son outil en ligne de commande n'est pas (encore) accessible.	Démarre Docker Desktop via le bouton du lanceur et attends un instant.

La détection de contexte avec messages détaillés est incluse à partir de la version du lanceur qui suit docker-app-launcher#26 ; les versions plus anciennes affichent les messages plus courts de la même table.

Téléchargement¶

Les trois lanceurs sont fournis à chaque version sur github.com/astrapi69/adaptive-learner/releases :

Plateforme	Fichier	Somme de contrôle
Linux	`adaptive-learner-launcher`	`adaptive-learner-launcher.sha256`
macOS	`adaptive-learner-launcher-macos.zip`	`adaptive-learner-launcher-macos.zip.sha256`
Windows	`adaptive-learner-launcher.exe`	`adaptive-learner-launcher.exe.sha256`

Ce qui est vérifié, et ce qui ne l'est pas¶

Chacun de ces programmes est démarré une fois lors de sa construction, précisément sur le système d'exploitation auquel il est destiné. Il est donc établi qu'il démarre : sous Linux, sous Windows et sous macOS sur Apple Silicon. L'image de l'application est vérifiée à chaque version : un téléchargement anonyme (sans connexion) et un démarrage réel avec contrôle de santé, séparément pour les deux types de processeur (Intel/AMD et ARM), sur des machines de ce type. Ce qui n'est pas encore mesuré, c'est le téléchargement depuis le registre sur de très anciens moteurs Docker (ère 20.10) ; la chaîne du moteur elle-même est prouvée sur un tel moteur contre un autre registre, et la mesure contre le registre GitHub est suivie upstream.

Ce qui n'est pas établi, c'est la réaction de votre système d'exploitation face à un fichier téléchargé : les programmes ne portent pas de signature payante, macOS avertit donc à la première ouverture (« développeur non identifié ») et Windows affiche l'avis SmartScreen. C'est un avertissement, pas un défaut ; la confirmation unique est décrite plus bas sous macOS et Windows. Vérifiez d'abord la somme de contrôle : c'est une preuve plus fiable que n'importe quelle boîte de dialogue.

Linux¶

Vérifie la somme de contrôle (les deux fichiers dans le même dossier) :
```
sha256sum -c adaptive-learner-launcher.sha256
```
Attribue le droit d'exécution. Le téléchargement par le navigateur le retire toujours au binaire, cette étape est donc toujours nécessaire :
```
chmod +x adaptive-learner-launcher
```
Démarre-le, le plus simple depuis le terminal :
```
./adaptive-learner-launcher
```
Le double-clic dans le gestionnaire de fichiers peut aussi fonctionner, selon ton environnement ; GNOME/Nautilus requiert "Autoriser l'exécution du fichier comme un programme" sous Propriétés > Permissions. Le démarrage depuis le terminal a l'avantage de te montrer directement les messages d'erreur.

Pièges connus :

"Permission denied" : l'étape 2 a été oubliée (chmod +x).
Erreur GLIBC au démarrage : le binaire est construit sur Ubuntu 22.04 et nécessite glibc 2.35 ou plus récent (Ubuntu 22.04+, Debian 12+, Fedora 36+). Sur les distributions plus anciennes, exécute plutôt l'application via install.sh ou directement avec Docker Compose.
Application inaccessible dans le navigateur : si le navigateur ne s'ouvre pas automatiquement, ouvre http://localhost:8501 manuellement (ou le port affiché dans la fenêtre du lanceur). Par défaut, l'application n'écoute que sur 127.0.0.1 et n'est donc accessible que depuis cet ordinateur ; d'autres appareils ne l'atteignent que si tu actives délibérément l'accès réseau - voir « Qui peut accéder à l'application » plus haut.

macOS¶

Vérifie la somme de contrôle et décompresse le ZIP :

shasum -a 256 -c adaptive-learner-launcher-macos.zip.sha256
unzip adaptive-learner-launcher-macos.zip

À la première ouverture, macOS bloque le programme. Selon la version de macOS, la boîte de dialogue ne propose que « Placer dans la corbeille » et « Terminé », sans bouton pour ouvrir. Ce n'est ni une erreur ni un défaut du programme : Adaptive Learner n'est pas certifié par Apple, ce qui exige un compte développeur payant.

Comment l'ouvrir malgré tout :

1. Ferme la boîte de dialogue avec **Terminé** (pas la corbeille).
2. Ouvre **Réglages Système > Confidentialité et sécurité** et
   descends tout en bas.
3. L'avertissement indiquant que le programme a été bloqué s'y
   trouve, avec le bouton **Ouvrir quand même**. Clique dessus et
   confirme dans la boîte suivante.

Les démarrages suivants se font sans question.

Ici, la somme de contrôle de l'étape 1 est ta véritable sécurité : le système ne peut pas te confirmer l'origine du fichier ; une somme identique, si.

Windows¶

Vérifie la somme de contrôle (PowerShell, les deux fichiers dans le même dossier) :
```
Get-FileHash .\adaptive-learner-launcher.exe -Algorithm SHA256
Get-Content .\adaptive-learner-launcher.exe.sha256
```
Les deux valeurs de hachage doivent correspondre.
Double-clique sur adaptive-learner-launcher.exe. Au premier démarrage, SmartScreen avertit ("Windows a protégé votre ordinateur") : clique sur Informations complémentaires, puis Exécuter quand même.

Si quelque chose se passe mal¶

Le lanceur affiche lui-même une boîte de dialogue lorsque Docker n'est pas en cours d'exécution et propose de démarrer Docker Desktop.
Le premier démarrage télécharge et construit l'image de l'application ; la liste d'étapes dans la fenêtre du lanceur (Check Docker / Download / Build / Start / Ready) montre la progression. Les démarrages suivants sont rapides.
Pendant que l'application tourne, tu peux toujours l'atteindre à http://localhost:8501 (ou ton port modifié) ; le bouton "Ouvrir dans le navigateur" du lanceur fait la même chose.