Installer avec un assistant de code

Un assistant de code qui travaille dans le terminal (Claude Code, Codex, Cursor, Gemini CLI, Aider…) peut installer Élise à votre place. Vous lui donnez un message qui décrit votre situation. Il suit ensuite des instructions publiques écrites pour lui, vérifie la machine et vous demande votre accord avant chaque action importante.

Ce parcours convient si vous utilisez déjà un tel assistant, ou si un proche à l’aise avec l’informatique vous accompagne. Il ne remplace pas votre regard : vous validez chaque étape.

Générer mon messageLe guide d’installation pose quelques questions et écrit le message adapté à votre machine, à votre réseau et à votre matériel.

Avant de commencer

Où lancer l’assistant

L’assistant doit tourner sur la machine qui fait le travail. Selon votre installation :

Situation	Où lancer l’assistant	Parcours suivi
Raspberry Pi 4 ou 5	Sur votre ordinateur (Mac, Windows ou Linux), celui qui a le lecteur de carte ou où se branche le SSD	B — image Raspberry Pi
Mini-PC sous Ubuntu Server 24.04	Sur le mini-PC, directement ou en SSH	A — installateur Ubuntu
NAS ou serveur qui a déjà Docker	Sur le serveur, en SSH	C — Docker Compose
Mac ou Windows seul, sans Docker	Nulle part : Élise a besoin d’un Raspberry Pi ou d’un serveur Linux	—

Ce qu’il vous faut

• Le matériel de votre parcours : voir Matériel requis.
• Un assistant installé, avec un compte chez son éditeur. Élise ne demande aucun compte.
• Le droit d’administrateur sur la machine : vous taperez vous-même le mot de passe quand le terminal le demandera.

1. Installer un assistant

Claude Code

Claude Code fonctionne sur macOS, Linux et Windows. Suivez l’installation officielle, puis lancez claude dans un terminal, dans un dossier vide.

Codex

Codex, d’OpenAI, s’installe depuis son dépôt officiel. Lancez ensuite codex dans un terminal, dans un dossier vide.

Cursor

Téléchargez Cursor. Pour un serveur, connectez Cursor à la machine en SSH, ouvrez un dossier vide, puis collez le message dans le panneau de l’agent.

Autres

Tout agent capable de lancer des commandes dans un terminal convient : Gemini CLI, Aider, GitHub Copilot en mode agent… Lancez-le sur la bonne machine (voir le tableau plus haut).

Astuce

Lancez l’assistant dans un dossier vide, par exemple ~/elise. Il y téléchargera les fichiers, sans toucher à vos documents.

2. Préparer le message

Le message dit à l’assistant où trouver les instructions, décrit votre matériel et rappelle les règles. Le plus simple est de le générer avec le guide d’installation, qui le remplit à partir de vos réponses. Voici des exemples complets pour chaque situation.

Pi · Mac

Vous copiez vous-même Élise avec Raspberry Pi Imager : l’assistant télécharge et vérifie l’image, puis vous guide.

Message à copier

Installe Élise OS en suivant les instructions officielles : https://eliseos.paulbreton.dev/install.md

Ma situation :
- Machine : un Raspberry Pi 5, qui démarrera sur le SSD.
- Tu es lancé sur : mon ordinateur Mac (macOS), qui sert à préparer le stockage.
- Parcours : B (image Raspberry Pi).
- Copie sur le stockage : je la fais moi-même avec Raspberry Pi Imager. Télécharge et vérifie l’image, dis-moi où elle se trouve, puis guide-moi dans Imager.
- Connexion : Wi-Fi. Rappelle-moi de le régler dans Imager ; je saisirai moi-même le mot de passe.
- Télévision : oui, en HDMI, avec une webcam USB pour les appels vidéo.
- Clé Zigbee : pas encore (je prévois une SONOFF ZBDongle-E).

Règles :
- Explique chaque étape en une ou deux phrases, en français simple.
- Demande mon accord avant toute commande sudo, toute installation et toute écriture sur un disque.
- Ne me demande jamais de mot de passe ni de jeton : je les taperai moi-même dans le terminal.
- Ne télécharge Élise que depuis github.com/Elise-OS/EliseOS.
- À la fin, dis-moi comment brancher le boîtier et quelle adresse ouvrir (http://elise.local).

Pi · Windows

Sous Windows, l’assistant travaille dans PowerShell et vérifie l’image avec Get-FileHash.

Message à copier

Installe Élise OS en suivant les instructions officielles : https://eliseos.paulbreton.dev/install.md

Ma situation :
- Machine : un Raspberry Pi 4, qui démarrera sur la carte microSD.
- Tu es lancé sur : mon ordinateur Windows (PowerShell), qui sert à préparer le stockage.
- Parcours : B (image Raspberry Pi).
- Copie sur le stockage : je la fais moi-même avec Raspberry Pi Imager. Télécharge et vérifie l’image, dis-moi où elle se trouve, puis guide-moi dans Imager.
- Connexion : câble réseau vers la box.
- Télévision : oui, en HDMI, sans caméra.
- Clé Zigbee : j’en ai une, elle sera branchée sur la machine.

Règles :
- Explique chaque étape en une ou deux phrases, en français simple.
- Demande mon accord avant toute commande sudo, toute installation et toute écriture sur un disque.
- Ne me demande jamais de mot de passe ni de jeton : je les taperai moi-même dans le terminal.
- Ne télécharge Élise que depuis github.com/Elise-OS/EliseOS.
- À la fin, dis-moi comment brancher le boîtier et quelle adresse ouvrir (http://elise.local).

Pi · écrit par l’assistant

Sur Mac ou Linux, l’assistant peut écrire lui-même la carte ou le SSD. Le Wi-Fi n’est alors pas réglé : branchez le boîtier par câble au premier démarrage.

Message à copier

Installe Élise OS en suivant les instructions officielles : https://eliseos.paulbreton.dev/install.md

Ma situation :
- Machine : un Raspberry Pi 5, qui démarrera sur le SSD NVMe.
- Tu es lancé sur : mon ordinateur Linux, qui sert à préparer le stockage.
- Parcours : B (image Raspberry Pi).
- Copie sur le stockage : c’est toi qui l’écris. Liste les disques, fais-moi identifier le bon par sa taille et son nom, et demande-moi deux confirmations avant d’écrire.
- Connexion : câble réseau vers la box.
- Télévision : non.
- Clé Zigbee : pas encore (je prévois une SONOFF ZBDongle-E).

Règles :
- Explique chaque étape en une ou deux phrases, en français simple.
- Demande mon accord avant toute commande sudo, toute installation et toute écriture sur un disque.
- Ne me demande jamais de mot de passe ni de jeton : je les taperai moi-même dans le terminal.
- Ne télécharge Élise que depuis github.com/Elise-OS/EliseOS.
- À la fin, dis-moi comment brancher le boîtier et quelle adresse ouvrir (http://elise.local).

Ubuntu

Message à copier

Installe Élise OS en suivant les instructions officielles : https://eliseos.paulbreton.dev/install.md

Ma situation :
- Machine : ce mini-PC sous Ubuntu Server 24.04. Tu es lancé dessus, directement ou en SSH.
- Parcours : A (installateur Ubuntu).
- Télévision : oui, en HDMI, avec une webcam USB pour les appels vidéo.
- Clé Zigbee : j’en ai une, elle sera branchée sur la machine.

Règles :
- Explique chaque étape en une ou deux phrases, en français simple.
- Demande mon accord avant toute commande sudo, toute installation et toute écriture sur un disque.
- Ne me demande jamais de mot de passe ni de jeton : je les taperai moi-même dans le terminal.
- Ne télécharge Élise que depuis github.com/Elise-OS/EliseOS.
- À la fin, vérifie qu’Élise répond et donne-moi l’adresse pour l’ouvrir.

Docker / NAS

Message à copier

Installe Élise OS en suivant les instructions officielles : https://eliseos.paulbreton.dev/install.md

Ma situation :
- Machine : ce serveur qui fait déjà tourner Docker. Tu es lancé dessus, en SSH.
- Parcours : C (Docker Compose). Je sais qu’il n’installe ni l’écran TV ni les mises à jour automatiques.
- Clé Zigbee : j’en ai une, elle sera branchée sur la machine.

Règles :
- Explique chaque étape en une ou deux phrases, en français simple.
- Demande mon accord avant toute commande sudo, toute installation et toute écriture sur un disque.
- Ne me demande jamais de mot de passe ni de jeton : je les taperai moi-même dans le terminal.
- Ne télécharge Élise que depuis github.com/Elise-OS/EliseOS.
- À la fin, vérifie qu’Élise répond et donne-moi l’adresse pour l’ouvrir.

Vous pouvez modifier le message librement : ajoutez par exemple « mon NAS est un Synology » ou « le port 8080 est déjà utilisé ». Gardez la première ligne et les règles.

3. Ce que fait l’assistant

Raspberry Pi

1. Il identifie votre système et trouve la dernière version publiée.

2. Il télécharge l’image (environ 1,6 Go) et son empreinte, puis vérifie que le fichier est intact.

3. Avec Raspberry Pi Imager : il vous indique où se trouve le fichier et vous guide dans Imager (nom d’hôte elise, Wi-Fi, pays, fuseau horaire).

   S’il écrit lui-même : il liste les disques, vous fait reconnaître le vôtre par sa taille et son nom, vous demande deux confirmations, puis écrit et éjecte le stockage.

4. Il vous explique comment brancher le boîtier, puis vous fait ouvrir http://elise.local.

Ubuntu

1. Il vérifie le système, l’architecture, la mémoire, le disque et les ports 8080, 18080 et 8555.

2. Après votre accord, il lance l’installateur officiel. Celui-ci vérifie la signature de la version, installe Docker, Tailscale et Avahi, puis démarre Élise.

3. Il contrôle qu’Élise répond (/api/v1/system/health) et vous donne l’adresse http://nom-de-la-machine.local:8080.

Docker / NAS

1. Il vérifie les versions de Docker et de Docker Compose, la mémoire et les ports 8080 et 8555.

2. Après votre accord, il télécharge le paquet de la version, vérifie son empreinte et l’extrait dans un dossier dédié.

3. Il prépare la configuration, détecte la clé Zigbee et démarre les services avec Docker Compose.

4. Il contrôle qu’Élise répond et vous donne l’adresse http://adresse-du-serveur:8080.

4. Garder la main

Les instructions publiques imposent à l’assistant de :

• n’utiliser que les sources officielles : github.com/Elise-OS/EliseOS et ce site ;
• expliquer chaque étape avant de la faire ;
• demander votre accord avant toute commande sudo, toute installation et toute écriture sur un disque ;
• ne jamais vous demander de mot de passe, de jeton ni de clé ;
• ne pas modifier le pare-feu, SSH ou le réseau au-delà de ce que fait l’installateur officiel ;
• s’arrêter et vous demander si quelque chose ne correspond pas.

Arrêtez l’assistant si…

• il vous demande un mot de passe dans la conversation : tapez-le seulement dans le terminal, quand sudo le demande ;
• il veut télécharger Élise depuis un autre site ;
• il propose d’écrire sur un disque que vous ne reconnaissez pas, ou dont la taille ne correspond pas à votre carte ou à votre SSD.

5. Après l’installation

L’assistant s’arrête quand Élise répond. La suite se fait dans le navigateur :

1. Premier démarrage : créer le compte administrateur, depuis la maison. Ou, sans ordinateur, depuis le téléphone.
2. Accès à distance : associer Tailscale et inviter les proches.
3. Capteurs et clé Zigbee : ajouter les capteurs, pièce par pièce.
4. Application mobile : l’installer chez les proches.

Dépannage

Ce que dit l’assistant	Que faire
« Le port 8080 est déjà utilisé »	Un autre service occupe le port. Demandez-lui lequel, puis choisissez : l’arrêter, ou installer Élise sur une autre machine.
« denied en téléchargeant une image Docker »	Un ancien identifiant ghcr.io traîne sur la machine. Les images sont publiques : il peut proposer docker logout ghcr.io.
« Système non pris en charge »	Élise demande Ubuntu Server 24.04 ou Docker sur Linux. Sur un Mac ou un PC Windows seul, préparez un Raspberry Pi.
elise.local ne s’ouvre pas	Attendez quelques minutes, vérifiez que le téléphone est sur le même réseau, ou utilisez l’application Élise, qui trouve le boîtier toute seule.

Pour les auteurs d’agents

Les instructions sont publiées en Markdown à /install.md, et un résumé du site à /llms.txt. Elles décrivent les trois parcours, les commandes exactes et les règles de sécurité.