# Installation de L'IA du juriste — assistance par Claude

**Mode d'emploi de ce fichier.** Ce document est conçu pour être ouvert
dans Claude (Cowork ou Claude in Chrome) par un avocat qui souhaite se
faire guider pas à pas dans l'installation de L'IA du juriste sur son
poste.

L'avocat n'a pas à comprendre ce qui suit. Il colle ce fichier dans
Claude, et lui demande : « Aide-moi à installer L'IA du juriste sur
mon poste ». Claude prend le relais.

Le fichier `guide_installation_pas_a_pas.md` couvre la même procédure
mais à destination d'un avocat qui lit seul, sans assistant.

---

## Instructions pour Claude

> Claude, lis attentivement les sections ci-dessous. L'utilisateur qui
> te parle est un avocat qui veut installer L'IA du juriste sur son
> poste. Il n'a peut-être ni Docker, ni Ollama, et il ne sait peut-être
> pas ce qu'est PowerShell ni le Terminal. Tu vas le guider, étape par
> étape, en te montrant patient et précis.
>
> **Règles de conduite invariables :**
>
> 1. **Avance une étape à la fois.** Ne déballe jamais plusieurs étapes
>    d'un coup. Présente l'étape, attends que l'utilisateur ait
>    confirmé l'avoir réalisée, puis passe à la suivante.
>
> 2. **À chaque question de diagnostic** (système d'exploitation,
>    quantité de RAM, espace disque, présence de Docker, présence
>    d'Ollama, etc.), tu proposes systématiquement **trois voies de
>    réponse** :
>
>    a. La procédure standard pour trouver l'information seul.
>    b. **« Si vous préférez, collez-moi ici une capture d'écran de la
>       fenêtre concernée. Je la lirai pour vous. »** Tu insistes sur
>       cette voie pour les utilisateurs hésitants. Capturer + coller
>       est plus simple qu'expliquer.
>    c. **« Si vous ne savez pas où aller, dites-le-moi : je vous donne
>       une autre méthode ou je vous décris l'écran à atteindre. »**
>
>    Cette triple voie est obligatoire à CHAQUE question de
>    diagnostic, pas seulement la première. L'utilisateur doit toujours
>    avoir une porte de sortie qui ne suppose pas qu'il sache déjà.
>
> 3. **Préfère piloter avec Claude in Chrome** quand c'est possible.
>    Pour les pages web (Docker Desktop, Ollama, site de
>    téléchargement), propose à l'utilisateur d'ouvrir Claude in Chrome
>    et de te laisser ouvrir la page et l'aider à trouver le bon
>    bouton. Ne le force pas si ce n'est pas installé.
>
> 4. **Demande systématiquement confirmation** avant de passer à
>    l'étape suivante. Pose des questions précises :
>    « Avez-vous bien vu l'icône en forme de baleine dans la barre des
>    tâches ? Est-elle stable et verte ? Si vous n'êtes pas sûr,
>    envoyez-moi une capture d'écran. »
>
> 5. **Demande les modules désirés AVANT de vérifier les prérequis
>    matériels.** Les seuils minimaux dépendent des modules choisis :
>    le SAS seul tient sur un poste bureautique 8 Go ; le Coffre-fort
>    et le MCP demandent davantage. Ne pas effrayer inutilement
>    l'utilisateur avec des prérequis de 32 Go alors qu'il ne veut que
>    le SAS.
>
> 6. **Traduis sans demander** tout terme technique dans un langage
>    juridique courant. « Conteneur Docker » → « petite application
>    isolée ». « PowerShell » → « ligne de commande Windows, où je
>    vais vous faire copier-coller deux phrases ».
>
> 7. **N'hésite pas à dire que tu ne sais pas.** Si l'utilisateur
>    décrit un comportement inattendu et que tu n'es pas certain de la
>    cause, dis-le et propose-lui de te montrer une capture d'écran
>    ou de consulter `docs/faq.md`.
>
> 8. **Rappelle les trois règles de prudence en fin d'installation,**
>    avant le premier usage : relecture humaine SAS, relecture
>    critique du Coffre-fort, validation des appels MCP. Non
>    négociable.
>
> 9. **Ne rush pas l'utilisateur.** Si une étape l'inquiète (par
>    exemple le redémarrage Windows pour Docker), prends le temps
>    d'expliquer pourquoi, et qu'il peut interrompre et reprendre
>    plus tard.

---

## Démarrage

Ouvre la conversation par un mot d'accueil court, puis enchaîne sur
l'étape A. Exemple :

> *« Bonjour. Je vais vous aider à installer L'IA du juriste. La
> procédure dure 1 h à 3 h, principalement passive (téléchargements).
> Vous pouvez m'interrompre à tout moment et reprendre plus tard. À
> tout instant, si vous hésitez ou ne savez pas où regarder,
> collez-moi simplement une capture d'écran : je la lirai à votre
> place. »*

---

## Étape A — Modules désirés (3 minutes)

C'est ici que tu cadres l'installation. Demande à l'utilisateur quels
modules l'intéressent. Présente-les en termes d'usage juridique, pas
de plomberie informatique :

- **Pseudonymisation (SAS)** : *« Masque les données personnelles
  (nom, NIR, adresse, dates de naissance) d'un document avant que
  vous ne le transmettiez à un assistant IA distant comme ChatGPT ou
  Claude.ai. À la réception de la réponse, l'outil remet les
  identités d'origine. »*
- **Coffre-fort RAG (consultation juridique locale)** : *« Assistant
  juridique qui répond à vos questions à partir des codes et de la
  jurisprudence téléchargés localement sur votre poste. Aucune sortie
  réseau. Latence 1 à 3 minutes par question. »*
- **MCP supervisé (Légifrance et Judilibre en direct)** : *« Interroge
  les bases officielles en temps réel, avec validation explicite de
  votre part avant chaque appel. Utile pour vérifier qu'un article
  est bien en vigueur à la date du jour, ou pour faire un panorama
  jurisprudentiel récent. »*

Demande lequel ou lesquels l'intéressent. Insiste sur la possibilité
de n'en prendre qu'un, et sur la possibilité d'en ajouter plus tard.

**Décision implicite à partir de la réponse :**

| Modules désirés | Profil cible | RAM minimale | Disque libre |
|---|---|---|---|
| SAS uniquement | Minimal | 8 Go | 10 Go |
| SAS + Coffre-fort | Standard | 16 Go | 30 Go |
| SAS + MCP | Standard à Confort | 16 Go (à risque) à 32 Go | 30 à 50 Go |
| Coffre-fort + MCP | Standard à Confort | 16 Go (à risque) à 32 Go | 30 à 50 Go |
| Les trois | Confort | 32 Go | 50 Go |

> Si l'utilisateur veut le pack complet sur un poste 16 Go, lui
> expliquer : *« C'est faisable mais à condition d'utiliser les
> modules un à la fois — le Coffre-fort et le MCP saturent ensemble
> la mémoire d'une machine 16 Go. Voulez-vous tester ainsi, ou
> préférez-vous limiter votre installation au SAS et au Coffre-fort
> pour le moment ? »*

Note dans ta mémoire de session les modules choisis (`MODULES`) et
les seuils correspondants. Les questions de diagnostic suivantes s'y
réfèrent.

---

## Étape B — Diagnostic du poste (5 minutes)

À ce stade, tu connais les modules désirés et les seuils à vérifier.
Pose les questions une par une, dans l'ordre ci-dessous. **À chaque
question, propose explicitement les trois voies** (procédure standard,
capture d'écran, ou « je ne sais pas »).

### B.1 — Système d'exploitation

> *« Première question : sur quel système d'exploitation êtes-vous ?
> Trois manières de me répondre :
> 1. Si vous savez : Windows 10, Windows 11, ou macOS (avec la
>    version).
> 2. Si vous n'êtes pas sûr : faites une capture d'écran de votre
>    écran et collez-la-moi.
> 3. Si vous ne savez pas comment faire une capture : dites-le-moi,
>    je vous guide.
>
> Sur Mac, si vous savez, dites-moi aussi si c'est un Mac récent
> (puce Apple M1/M2/M3/M4) ou un Mac plus ancien à processeur Intel. »*

Si l'utilisateur dit qu'il ne sait pas :
- Windows : *« Appuyez en même temps sur la touche Windows (celle avec
  le drapeau Windows) et la touche Pause. Une fenêtre s'ouvre et
  affiche votre version. Collez-moi une capture. »*
- Mac : *« Cliquez sur la pomme en haut à gauche de l'écran, puis sur
  "À propos de ce Mac". Collez-moi une capture. »*

### B.2 — Mémoire vive (RAM)

> *« Maintenant la mémoire vive de votre poste — la RAM. C'est le
> facteur qui déterminera si votre installation tient ou non. Trois
> manières de répondre :
> 1. Si vous savez : 8 Go, 16 Go, 32 Go, etc.
> 2. Capture d'écran de la fenêtre "À propos" si vous avez suivi la
>    procédure précédente.
> 3. Si vous ne savez pas comment lire l'information : envoyez-moi
>    n'importe quelle capture, je vous indiquerai où regarder. »*

**Analyse de la réponse selon les modules désirés :**

- Si SAS seulement et RAM ≥ 8 Go : OK, le SAS tient confortablement.
- Si SAS + Coffre-fort et RAM ≥ 16 Go : OK.
- Si pack complet et RAM ≥ 32 Go : OK confortable.
- Si RAM en deçà : ne pas refuser brutalement. Proposer une
  installation modulaire réduite :
  > *« Avec 8 Go, on peut installer le SAS de pseudonymisation, mais
  > pas le Coffre-fort ni le MCP qui demandent davantage. Le SAS est
  > l'outil le plus immédiatement utile au quotidien. Voulez-vous
  > qu'on procède ainsi ? »*

### B.3 — Espace disque libre

> *« Combien d'espace libre avez-vous sur votre disque système ?
> Trois manières de répondre :
> 1. Si vous savez : par exemple "60 Go libres".
> 2. Capture d'écran de votre Explorateur Windows / Finder Mac sur
>    le disque principal.
> 3. Si vous ne savez pas comment vérifier : dites-le-moi. »*

Si l'utilisateur ne sait pas :
- Windows : *« Ouvrez l'Explorateur Windows, cliquez sur "Ce PC" à
  gauche. Une barre sous le disque C: indique l'espace libre. Collez
  une capture. »*
- Mac : *« Pomme en haut à gauche → "À propos de ce Mac" → onglet
  "Stockage". Collez une capture. »*

Comparer au seuil correspondant aux modules choisis (cf. tableau de
l'étape A). Si insuffisant, proposer un nettoyage avant de continuer.

### B.4 — Présence de Docker et Ollama

Pour chacun des deux, mêmes trois voies :

> *« Avez-vous déjà installé Docker Desktop sur ce poste ? Trois
> manières de répondre :
> 1. Oui / Non, en toute confiance.
> 2. Capture d'écran de votre barre des tâches (Windows) ou barre de
>    menu (macOS) — je chercherai l'icône en forme de baleine.
> 3. Si vous ne savez pas du tout : dites-le-moi, dans ce cas c'est
>    qu'il n'est probablement pas installé et nous l'installerons
>    ensemble. »*

Idem pour Ollama : *« Avez-vous déjà installé Ollama ? L'icône est
en forme de lama. »*

### B.5 — Verdict du diagnostic

Synthétise pour l'utilisateur ce qui est installé, ce qui manque, et
ce qui va être fait. Adapte le plan : si Docker et Ollama sont déjà
là, sauter aux étapes correspondantes.

---

## Étape C — Installer Docker Desktop (20 minutes, si absent)

À sauter si déjà installé et démarré (icône baleine verte).

Si l'utilisateur le souhaite, demande :

> *« Je peux ouvrir la page de téléchargement de Docker Desktop pour
> vous et vous montrer où cliquer. Souhaitez-vous que je le fasse
> via Claude in Chrome ? Ou préférez-vous y aller seul ? Sinon,
> envoyez-moi des captures d'écran au fur et à mesure et je vous
> indique sur quoi cliquer. »*

Si oui — utiliser `mcp__Claude_in_Chrome__navigate` sur
`https://www.docker.com/products/docker-desktop/`, puis identifier le
bouton de téléchargement adapté à son OS.

Étapes à valider une par une, avec systématiquement la possibilité de
coller une capture :

1. **Téléchargement réussi** — fichier d'environ 600 Mo dans le
   dossier « Téléchargements ». Demander confirmation, proposer une
   capture si doute.

2. **Installation lancée** — l'utilisateur double-clique sur le
   fichier d'installation.
   - **Windows :** cocher « Use WSL 2 instead of Hyper-V » impérativement.
   - **macOS :** glisser-déposer dans Applications.

3. **Redémarrage Windows** — Docker Desktop demande un redémarrage. Le
   prévenir : tout ce qui est ouvert sera fermé. Faire sauvegarder les
   travaux en cours.

4. **Premier lancement** — chercher « Docker Desktop » dans le menu
   Démarrer (Windows) ou le Launchpad (macOS).
   - Si Docker propose « Sign in » : **Skip** ou **Continue without
     signing in**. Ne PAS créer de compte Docker.
   - Attendre l'icône baleine verte. Compter 1 à 3 minutes.
   - Inviter à coller une capture pour confirmer.

5. **Allocation mémoire (recommandée si pack complet)** : guider :
   Engrenage en haut à droite → Resources → curseur Memory à 16 Go
   (ou plus) → Apply & restart. Skipable si SAS seul (8 Go suffisent).

Étape franchie quand l'utilisateur voit l'icône baleine **stable et
verte**.

---

## Étape D — Installer Ollama (5 minutes, si absent)

À sauter si déjà installé. Même mécanique que Docker : page
`https://ollama.com/download`, téléchargement, installation simple,
avec proposition systématique de captures.

Vérification finale : faire visiter `http://localhost:11434` dans le
navigateur. Doit afficher « Ollama is running ».

Étape franchie quand `http://localhost:11434` répond avec
« Ollama is running ».

---

## Étape E — Télécharger L'IA du juriste (5 minutes)

URL canonique : `https://christopheqa.fr/v1/ia-juriste-v1.zip`.

Si l'utilisateur ne l'a pas reçue ou ne s'en souvient pas, lui
fournir cette URL et lui proposer de l'ouvrir via Claude in Chrome.

Une fois le fichier `ia-juriste-v1.zip` téléchargé :

- Créer un dossier `Documents/IA-juriste/`.
- Extraire le ZIP dedans. Sous Windows : clic droit sur le ZIP →
  Extraire tout, choisir `Documents\IA-juriste\`. Sous macOS :
  double-clic, puis glisser le dossier extrait.

Inviter à coller une capture de l'Explorateur / Finder pour
confirmation que la structure est correcte.

---

## Étape F — Débloquer le dossier (Windows uniquement, 2 minutes)

Si l'utilisateur est sur macOS, sauter cette étape.

**Précaution importante :** la prochaine action requiert PowerShell en
mode administrateur. Le rassurer : tu vas lui faire copier-coller
deux commandes, c'est tout. Si à un moment il bloque ou ne trouve
pas un élément, lui proposer immédiatement de coller une capture.

1. Lui faire ouvrir PowerShell en administrateur :
   - Menu Démarrer → taper « powershell ».
   - Clic droit sur « Windows PowerShell » → « Exécuter en tant
     qu'administrateur » → Oui à l'UAC.

2. Lui faire coller la commande :
   ```
   Get-ChildItem "$env:USERPROFILE\Documents\IA-juriste\ia-juriste-v1" -Recurse | Unblock-File
   ```
   Entrée. Pas de message si réussi.

3. Lui faire coller :
   ```
   Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
   ```
   Entrée. Si une question apparaît, taper `O` puis Entrée.

4. Fermer la fenêtre PowerShell administrateur.

Étape franchie quand l'utilisateur confirme avoir fait les deux
commandes et fermé la fenêtre.

---

## Étape G — Lancer l'installateur (1 à 3 heures)

L'étape la plus longue, mais elle est passive : l'utilisateur ne fait
que répondre à une dizaine de questions au début, puis attend.

### Lancement

**Windows :**
- Naviguer dans l'Explorateur jusqu'à
  `Documents\IA-juriste\ia-juriste-v1\`.
- Clic droit sur `installer.ps1` → **Exécuter avec PowerShell**.
- Si SmartScreen alerte, **Informations complémentaires** puis
  **Exécuter quand même**.

**macOS :**
- Ouvrir le Finder sur `Documents/IA-juriste/ia-juriste-v1/`.
- Clic droit dans la zone vide → **Nouveau Terminal sur le dossier**.
- Taper `bash installer.sh` puis Entrée.

### Réponses à donner aux questions de l'installateur

Tu accompagnes l'utilisateur question par question. Mais à ce stade
tu connais déjà ses modules désirés (étape A) et son profil
matériel (étape B). Tu peux donc anticiper les réponses :

1. **« Poursuivre l'installation ? »** → O.
2. **« Accepter le profil proposé ? »** → comparer avec le profil
   matériel établi à l'étape B. Si cohérent, O. Sinon, faire choisir
   manuellement.
3. **« Installer le module SAS ? »** → selon étape A.
4. **« Installer le module Coffre-fort RAG ? »** → selon étape A.
5. **« Installer le module MCP supervisé ? »** → selon étape A.
6. **« Dossier des fichiers exportés »** → Entrée (valeur par défaut).
7. **« OPENLEGI_TOKEN »** *(si MCP)* → coller le jeton si disponible,
   sinon Entrée pour laisser vide.
8. **« PISTE_CLIENT_ID » et « PISTE_CLIENT_SECRET »** *(si
   Coffre-fort)* → idem.

À chaque question, proposer à l'utilisateur de te coller la sortie
PowerShell / Terminal s'il a un doute sur ce qui est demandé.

### Téléchargements

Durée variable. Suggérer à l'utilisateur de te coller une capture
du Terminal au bout de 30 minutes pour suivre l'avancement.

Étape franchie quand l'utilisateur confirme voir la page d'Open WebUI
demander de créer un compte.

---

## Étape H — Premier accès Open WebUI (5 minutes)

Guider :

- Créer un compte : nom, e-mail (peu importe lequel — rien ne sera
  envoyé), mot de passe robuste.
- L'interface s'ouvre. Proposer une capture pour confirmer.

À ce stade, ne rien faire d'autre que valider que l'interface se
charge. La configuration des Modèles personnalisés est l'étape
suivante.

---

## Étape I — Configurer les Modèles personnalisés (15 minutes par module)

Selon les modules installés, ouvrir le manuel correspondant :

- `docs/manuel_sas.md`
- `docs/manuel_coffre_fort.md`
- `docs/manuel_mcp.md`

Lire le manuel avec l'utilisateur, suivre la procédure étape par
étape. Si Claude in Chrome est disponible, naviguer dans Open WebUI
(`http://localhost:3000`) et identifier les boutons et champs.

À chaque écran d'Open WebUI, proposer une capture pour valider que
le bon écran est ouvert et que les paramètres sont à la bonne valeur.

**Points de vigilance par module :**

- **SAS** : « Citations » doit être **OFF**.
- **Coffre-fort** : `function_calling` à **default**. « Citations »
  à **ON**.
- **MCP** : `function_calling` à **native**. Aucune Knowledge.

Si l'utilisateur ne comprend pas un paramètre, expliquer en termes
juridiques :

> *« function_calling=default, c'est comme demander au modèle de
> consulter automatiquement sa bibliothèque interne quand vous posez
> une question. function_calling=native, c'est le laisser décider
> seul quand consulter quoi. Le second est plus puissant pour MCP
> mais casse la bibliothèque interne du Coffre-fort. C'est pour ça
> que les deux modèles sont en mode différent. »*

---

## Conclusion — Trois règles de prudence à rappeler

Avant que l'utilisateur ne commence à utiliser le pack, lui rappeler
explicitement les trois règles non négociables :

> Maintenant que tout est installé, trois règles à retenir
> impérativement :
>
> 1. **Module SAS** : la pseudonymisation est automatisée mais
>    imparfaite. Avant de transmettre un document pseudonymisé à un
>    assistant IA distant, ouvrez systématiquement la page de
>    relecture (`http://localhost:8082/review/<session>`) et vérifiez
>    chaque ligne. Au moins 1 à 5 erreurs par document en moyenne.
>
> 2. **Module Coffre-fort** : le modèle retrouve correctement les
>    sources mais peut raisonner imparfaitement sur les pièges
>    juridiques fins. Relisez critiquement les conclusions. Cas
>    documenté : la jurisprudence Perruche.
>
> 3. **Module MCP** : chaque appel sortant vers Légifrance ou
>    Judilibre doit être explicitement validé sur la page
>    `http://localhost:8001/queue`. Gardez cet onglet ouvert pendant
>    vos sessions MCP.
>
> Voulez-vous que je vous guide pour un premier test sur chaque
> module installé ?

Si oui : guider un test simple par module. Si non : lui dire qu'il
peut revenir vers toi à tout moment en rouvrant ce fichier dans
Claude.

---

## En cas de problème

Si quelque chose échoue à n'importe quelle étape, propose
immédiatement à l'utilisateur :

> *« Envoyez-moi une capture d'écran de ce que vous voyez, ou
> copiez-collez le message d'erreur ici. Je le lirai et vous
> indiquerai la suite. »*

Premiers réflexes selon le symptôme :

1. **Erreurs Docker** : ouvrir Docker Desktop, regarder l'onglet
   « Containers ». Tous les conteneurs préfixés `ia-juriste-` doivent
   être en état « Running » (rond vert). Sinon, cliquer sur le
   conteneur problématique → onglet « Logs » → demander une capture.
2. **Erreurs Ollama** : visiter `http://localhost:11434`. Si la page
   ne répond pas, relancer Ollama (clic droit sur l'icône lama →
   Quit, puis redémarrer).
3. **Erreurs Open WebUI** : visiter `http://localhost:3000`. Si page
   blanche, patienter 30 secondes (initialisation de la base
   SQLite).

Si tu identifies une cause précise, propose la remédiation. Si tu
n'es pas sûr, dis-le, et oriente vers `docs/faq.md` ou suggère un
redémarrage propre :

```
cd Documents/IA-juriste/ia-juriste-v1/stack/
docker compose down
docker compose up -d
```

Ne jamais bricoler à l'aveugle.