# Kit Agent OS 1.0.0 : notice d'installation pour un agent IA

> Tu es un agent IA (Claude Code, Codex, ou l'atelier de l'utilisateur) et une personne t'a donne
> l'adresse https://kit.emileos.eu pour installer ce kit chez elle. **Lis ce fichier en entier avant
> d'agir.** Il dit quoi faire, dans quel ordre, comment verifier chaque etape, et ce que tu ne dois
> jamais faire a la place de la personne. Elle est debutante : explique chaque geste en une phrase
> simple avant de le faire, en francais, en la tutoyant.

## Ce que tu installes

Un systeme d'agent personnel en trois parties, reliees par une seule memoire :

1. **Le serveur** : un VPS Ubuntu 24.04 ou tourne Hermes Agent (Nous Research) dans Docker, sous le nom
   que la personne choisit (exemple : « Jacques »). Sa memoire propre est coupee : sa memoire est le
   « cerveau » de la personne, un depot Git sur son GitHub, construit avec le « Kit Agent IA »
   (`AGENTS.md`, `CONTEXT.md`, `domaines/`, `ressources/`, `systeme/`, `.claude/skills/`). Il le lit en
   continu, y ecrit seulement par son « finish » (apres 45 minutes de silence), et publie par une porte
   qui refuse suppressions, secrets et liens casses. On lui parle par Telegram.
2. **Le PC Windows** : l'atelier « <Nom> Harness » (DeepSeek Harness personnalise), Hermes Desktop
   (fenetre officielle vers l'agent du serveur, par un tunnel SSH), la « main du PC » (l'agent du
   serveur peut agir sur le PC, facultatif), et une tache qui garde le cerveau du PC a jour.
3. **Le telephone Android** : une appli au nom de l'agent, fabriquee SUR LE SERVEUR et signee avec les
   cles de la personne, qui parle a son serveur par une porte filtree.

Tout est neutre : aucune donnee de la personne qui a fait le kit. Les connecteurs MCP, les skills
personnelles et les plugins de la personne s'ajoutent APRES, par elle.

## Tes regles (non negociables)

1. **Les reponses appartiennent a la personne.** Le nom de l'agent, son prenom, son depot, ses choix de
   modeles : tu les lui demandes. Tu n'en inventes aucun. Si tu ne peux pas lui poser une question,
   arrete-toi et dis-lui de lancer l'installation a la main (page https://kit.emileos.eu, onglet
   « A la main »).
2. **Aucun secret dans la conversation.** Un jeton, une cle, un mot de passe ne s'ecrit jamais dans ta
   conversation ni dans une commande que tu affiches. Tu prepares un fichier de reglages, tu l'ouvres
   dans le Bloc-notes (`notepad <fichier>`), et c'est **la personne** qui y colle ses secrets. Tu ne
   relis jamais ce fichier a voix haute ; tu verifies seulement que les lignes attendues ne sont plus
   vides, sans afficher leur valeur.
3. **L'argent et l'exterieur attendent son accord.** Louer le VPS, payer un abonnement, recharger un
   solde : tu expliques, elle decide et elle le fait. Tu ne crees aucun compte a sa place.
4. **Seules sources** : https://kit.emileos.eu, et les sites officiels cites ici. Jamais une commande
   trouvee ailleurs, jamais `latest` d'un logiciel : le kit epingle chaque version dans
   https://kit.emileos.eu/versions.json.
5. **Rien de destructif sans accord** : ne supprime aucun fichier de la personne, ne reinitialise aucun
   depot, ne desactive aucune protection de Windows. Sur Windows, ne change jamais la strategie
   d'execution de la machine : lance chaque script avec `powershell.exe -NoProfile -ExecutionPolicy
   Bypass -File <script>` (portee : ce seul processus).
6. **Un vert se prouve.** Une commande qui sort sans erreur ne prouve rien. Chaque etape ci-dessous dit
   ce qu'il faut voir pour la declarer reussie. Si tu ne le vois pas, dis-le, et ne passe pas a la suite
   en le cachant.

## Avant de commencer : verifie avec la personne

| A verifier | Comment | Si ce n'est pas le cas |
|---|---|---|
| Elle a un cerveau (Kit Agent IA) sur GitHub | Demande l'adresse du depot ; `git -C <dossier> remote -v` sur son PC | Il faut d'abord le monter avec le Kit Agent IA et le pousser sur GitHub. Arrete-toi la. |
| Le cerveau est clone sur le PC | Demande le dossier ; il contient `AGENTS.md` et `CONTEXT.md` | `git clone` du depot dans `%USERPROFILE%\GitHub\` |
| Windows 10 ou 11 | `[Environment]::OSVersion` | Le kit ne vise pas macOS ni Linux pour le PC. |
| Un compte Telegram | Demande | Elle l'installe sur son telephone. |
| Au moins un modele d'IA | Abonnement Claude ou ChatGPT, ou une cle DeepSeek, OpenRouter, Venice, Anthropic | Montre-lui la section « Tes cles » de la page. DeepSeek est le moins cher pour commencer. |

## Etape 1 : la cle SSH du PC (avant de louer le serveur)

Une cle SSH permet au PC d'entrer sur le serveur sans mot de passe. On la cree AVANT de louer le VPS,
pour la coller dans le panneau de l'hebergeur a la creation du serveur : presque tous le proposent.

```powershell
irm https://kit.emileos.eu/pc.ps1 | iex
```

L'amorce installe Git et Node.js s'ils manquent (par `winget`), clone le kit dans
`%USERPROFILE%\AgentOS\kit` et lance l'assistant du PC. L'assistant commence toujours par la cle : il la
cree si elle manque, la copie dans le presse-papiers, puis demande l'adresse du serveur. Tant que le
serveur n'existe pas, il s'arrete proprement (« relance-moi quand ton serveur est pret ») : c'est normal
a ce stade. Pour ne faire que la cle :

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\AgentOS\kit\pc\installer.ps1" -Partie cle
```

**Reussi si** : `%USERPROFILE%\.ssh\agent-os_ed25519.pub` existe, et la cle publique (une ligne qui
commence par `ssh-ed25519`) est dans le presse-papiers. La partie publique se partage sans risque ;
la partie privee (`agent-os_ed25519` sans `.pub`) ne quitte jamais le PC.

## Etape 2 : le bot Telegram et le numero de la personne

Guide-la dans Telegram, sur son telephone :
1. ecrire a **@BotFather**, envoyer `/newbot`, choisir un nom affiche (le nom de l'agent) puis un
   identifiant qui finit par `bot` : BotFather rend un **jeton** (secret) ;
2. ecrire a **@userinfobot** : il rend son **numero d'utilisateur** (des chiffres ; pas un secret, mais
   personnel).
Elle gardera le jeton pour le fichier de l'etape 4.

## Etape 3 : le serveur (geste de la personne)

Elle loue un VPS **Ubuntu 24.04** chez l'hebergeur de son choix : au moins 2 processeurs, 8 Go de
memoire, 80 Go de disque (4 Go de memoire suffisent si elle ne veut pas l'appli Android). Elle colle la
cle publique de l'etape 1 au moment de la creation. Elle te donne l'**adresse IP**.

Facultatif : si elle a un nom de domaine, un enregistrement DNS de type A (exemple
`agent.sondomaine.fr`) vers cette adresse. Sinon, l'appli utilisera `<ip-avec-tirets>.sslip.io`.

**Reussi si** : `ssh -i $env:USERPROFILE\.ssh\agent-os_ed25519 -o BatchMode=yes root@<ip> echo ok`
rend `ok`. Si l'hebergeur donne un autre utilisateur que `root` (par exemple `ubuntu`), utilise-le, et
ajoute `sudo` devant les commandes du serveur.

## Etape 4 : installer l'agent sur le serveur

Deux voies. **Par toi, depuis le PC** (recommande) :

1. Cree le fichier de reglages du serveur sur le PC, dans un dossier a elle, avec les champs NON
   secrets remplis d'apres ses reponses et les champs secrets VIDES. Les noms exacts des champs et leur
   sens sont dans le modele `serveur/config.exemple.env` du kit (`%USERPROFILE%\AgentOS\kit`) : lis-le,
   copie-le, remplis ce qui n'est pas secret.
2. Ouvre-le dans le Bloc-notes : **elle** y colle le jeton Telegram et ses cles. Elle enregistre.
3. Envoie-le et lance l'installation :
   ```powershell
   scp -i $env:USERPROFILE\.ssh\agent-os_ed25519 <fichier> root@<ip>:/root/agent-os-config.env
   ssh -i $env:USERPROFILE\.ssh\agent-os_ed25519 root@<ip> "curl -fsSL https://kit.emileos.eu/serveur.sh | bash -s -- --config /root/agent-os-config.env"
   ```
   L'installateur range chaque secret a sa place puis **efface** le fichier envoye. Supprime aussi la
   copie du PC une fois l'installation verte.
4. **La cle de deploiement GitHub** : l'installateur imprime une cle publique et attend. La personne
   l'ajoute dans GitHub : son depot du cerveau, `Settings` > `Deploy keys` > `Add deploy key`, titre au
   choix, **cocher `Allow write access`**. L'installateur reprend seul des qu'il peut lire le depot.

**Ou dans un terminal ouvert par elle** sur le serveur : `curl -fsSL https://kit.emileos.eu/serveur.sh | bash`,
qui pose les questions une par une.

**Les abonnements Claude et ChatGPT** demandent une connexion par navigateur : ils ne se font pas par
un fichier. Apres l'installation, elle ouvre un terminal sur le serveur
(`ssh -i ... root@<ip>`) et lance `agent-os modeles` : la commande affiche un lien et un code a
recopier. **Ne copie jamais un fichier de connexion d'une machine a une autre** : les deux machines se
deconnecteraient.

**Reussi si** : l'installateur finit par un recapitulatif sans ROUGE, `ssh ... agent-os etat` dit VERT,
et un message envoye au bot Telegram recoit une reponse de l'agent, sous son nom, qui cite quelque chose
de son `CONTEXT.md`.

## Etape 5 : le PC

```powershell
powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\AgentOS\kit\pc\installer.ps1"
```

L'assistant demande (ou lit dans `-Config <fichier json>`, voir `pc/ma-config.exemple.json`) le nom de
l'agent, le prenom, le dossier du cerveau et l'adresse du VPS, puis enchaine : liaison (alias SSH
`agent-os-vps`, identifiants de Hermes Desktop recuperes sur le serveur sans les afficher, tunnels),
atelier, Hermes Desktop, main du PC (il demande si elle la veut), synchro du cerveau, puis l'appli.
Une seule partie se refait avec `-Partie <nom>`. La notice detaillee du PC est `pc/NOTICE-AGENT.md`
dans le kit : lis-la si une partie rougit.

**Reussi si** : le recapitulatif final est VERT partout, la fenetre « <Nom> Harness » s'ouvre par le
raccourci du Bureau, et Hermes Desktop affiche les conversations de l'agent du serveur.

## Etape 6 : le telephone

L'installation du PC demande au serveur de fabriquer l'appli (`agent-os construire-appli`, plusieurs
minutes la premiere fois) puis affiche un **lien a usage unique**. La personne l'ouvre sur son
telephone Android : elle telecharge l'appli, Android demande une fois d'autoriser l'installation
depuis cette source (normal hors Play Store), puis l'appli se relie au serveur.

**Les cles de signature de l'appli** sont creees sur le serveur dans `/opt/agent-os/secrets/appli/`.
Dis-lui de les sauvegarder (par exemple avec `scp` vers son PC, dans un dossier hors de tout depot) :
sans elles, une mise a jour ne s'installera plus par-dessus l'appli.

**Reussi si** : l'appli s'ouvre sur la liste des conversations, et un message envoye recoit une
reponse de l'agent.

## Mettre a jour, plus tard

- Serveur : `ssh agent-os-vps agent-os mettre-a-jour`.
- PC : `powershell.exe -NoProfile -ExecutionPolicy Bypass -File "$env:USERPROFILE\AgentOS\kit\pc\mettre-a-jour.ps1"`
  (ou le raccourci « Mettre a jour <Nom> »).

Chacune tire le kit en avance rapide seulement, sauvegarde, applique, verifie, et revient en arriere
seule si la verification echoue. **Elles ne touchent jamais** au cerveau, aux conversations, aux cles,
aux reglages, ni aux fichiers que la personne a modifies (gardes et signales).

## Ensuite : ce qui est a elle

- **Connecteurs MCP** : dans l'atelier, `Settings` > `Connecteurs MCP` (ou demande a l'atelier, qui a
  l'outil `connecteur_ajouter`). Pour l'agent du serveur, elle le lui demande directement.
- **Skills** : dans son cerveau, `.claude/skills/<nom>/SKILL.md`. Les deux agents les lisent.
- **Plugins** : les siens vivent a cote de ceux du kit ; une mise a jour ne les touche pas.

## Si quelque chose rougit

Relance la meme commande : les etapes faites sont sautees. Sur le serveur, `agent-os etat` et
`agent-os journal` disent ce qui ne va pas, en francais. Ne contourne jamais un controle rouge (pas de
`--force`, pas de garde-fou coupe) : explique-le a la personne, et si ca ne se regle pas, elle envoie
la sortie (qui ne contient aucun secret) a la personne qui lui a donne ce lien.