# Guide d'installation pas-à-pas — L'IA du juriste

**Public visé :** vous, qui n'avez peut-être jamais entendu parler de Docker
ni d'Ollama, qui n'avez jamais ouvert PowerShell ou le Terminal, et qui
souhaitez installer L'IA du juriste sur votre poste de travail sans
détour technique.

**Si à un moment vous êtes perdu**, deux secours sont possibles :

- Ouvrir le fichier `docs/installation_avec_claude.md` dans Claude
  (Cowork ou Claude in Chrome). Claude prendra le relais et vous
  guidera oralement, étape par étape, en lisant les captures d'écran
  que vous lui collez.
- Consulter `docs/faq.md` qui répond aux questions courantes.

**Temps total estimé :** entre 1 h et 3 h selon votre connexion internet.

---

## Avant de commencer — quel module installer ?

L'IA du juriste se compose de trois modules indépendants. Vous
n'êtes pas obligé de tout installer : choisissez selon vos besoins,
vous pourrez ajouter le reste plus tard.

| Module | Ce qu'il fait | Quand l'utiliser |
|---|---|---|
| **SAS de pseudonymisation** | Masque les données personnelles d'un document (noms, adresses, NIR, dates de naissance) avant que vous ne le transmettiez à un assistant IA distant (ChatGPT, Claude.ai, etc.), et remet les identités d'origine dans la réponse. | Vous voulez utiliser des assistants IA distants sans exposer les données de vos dossiers. |
| **Coffre-fort RAG** | Assistant juridique qui répond à vos questions à partir des codes et de la jurisprudence téléchargés sur votre poste. Aucune sortie réseau. | Vous voulez un assistant juridique privé pour vos recherches quotidiennes. |
| **MCP supervisé** | Interroge Légifrance et Judilibre en temps réel, avec validation explicite de votre part avant chaque appel sortant. | Vous voulez vérifier régulièrement qu'un article est en vigueur, ou faire un panorama jurisprudentiel récent. |

### Prérequis matériels selon les modules choisis

Les besoins en mémoire (RAM) et en espace disque dépendent fortement de
ce que vous choisissez d'installer :

| Combinaison de modules | RAM minimale | Disque libre | Profil |
|---|---|---|---|
| SAS uniquement | **8 Go** | 10 Go | bureautique standard |
| SAS + Coffre-fort | **16 Go** | 30 Go | poste équipé |
| Pack complet (SAS + Coffre-fort + MCP) | **32 Go** | 50 Go | poste haut de gamme |

Le SAS seul tient sur une machine bureautique ordinaire. Le Coffre-fort
demande davantage parce qu'il fait tourner un modèle de langage local de
15 Go en mémoire. Le pack complet exige un poste haut de gamme à cause
de la cohabitation des deux modules de langage.

**Si vous hésitez sur ce que peut votre machine** : commencez par
installer le SAS uniquement. Vous pourrez relancer l'installateur plus
tard pour ajouter le Coffre-fort ou le MCP si votre poste le permet.

---

## Étape 1 — Préparer votre poste (5 minutes)

### 1.1 Vérifier la mémoire vive (RAM)

L'IA du juriste a besoin d'au moins **8 Go de RAM** pour le SAS,
**16 Go** pour ajouter le Coffre-fort, **32 Go** pour le pack complet.

**Sous Windows :**

1. Appuyer simultanément sur les touches `Windows` (touche avec le
   drapeau Windows) et `Pause` (en haut à droite du clavier sur les
   claviers classiques).
2. Une fenêtre s'ouvre, intitulée « À propos ». Chercher la ligne
   « Mémoire installée (RAM) ». Le chiffre y figure (par exemple
   « 16,0 Go »).

**Sous macOS :**

1. Cliquer sur la pomme en haut à gauche de l'écran.
2. Cliquer sur « À propos de ce Mac ». Une fenêtre s'ouvre. La ligne
   « Mémoire » indique la valeur (par exemple « 16 Go »).

**Si vous n'arrivez pas à trouver l'information :**

- Sur Windows, la touche `Pause` n'existe pas sur tous les claviers.
  Méthode alternative : faire clic droit sur l'icône Windows en bas à
  gauche → choisir « Système ». La même information apparaît.
- Sur Mac portable récent (M1, M2, M3, M4), la mémoire est dite
  « unifiée » — c'est le même chiffre qui compte.
- Vous pouvez aussi ouvrir Claude in Chrome ou Cowork et lui demander :
  *« Pouvez-vous m'aider à trouver ma mémoire vive ? Je vais coller
  une capture d'écran. »* Claude saura interpréter ce que vous voyez.

Notez le chiffre. Si vous avez moins de 8 Go, l'installation ne peut
pas aboutir pour les configurations bureau-tiques standard
d'aujourd'hui.

### 1.2 Vérifier l'espace disque libre

**Sous Windows :**

1. Ouvrir l'Explorateur Windows (icône dossier dans la barre des
   tâches, ou raccourci `Windows + E`).
2. Cliquer sur « Ce PC » dans le menu de gauche.
3. Sous votre disque C:, la barre indique l'espace libre.

**Sous macOS :**

1. Cliquer sur la pomme en haut à gauche.
2. « À propos de ce Mac », puis onglet « Stockage ». La barre affiche
   l'espace disponible.

**Si vous n'arrivez pas à le voir :**

- Sur Windows, l'option « Ce PC » s'appelle aussi parfois
  « Cet ordinateur ». Vous pouvez aussi taper `Win + R`, puis
  `explorer` et `Entrée`.
- Sur Mac, si vous n'avez pas l'onglet « Stockage », c'est que vous
  êtes sur une version macOS plus ancienne — cliquer sur l'onglet
  « Plus d'infos » ou « Rapport système » puis « Stockage ».
- Vous pouvez aussi demander à Claude de regarder une capture
  d'écran de votre Explorateur ou Finder.

Si l'espace libre est insuffisant pour la combinaison de modules
choisie (cf. tableau plus haut), faites un peu de ménage avant de
poursuivre.

### 1.3 Vérifier votre connexion internet

Vous allez télécharger environ :
- 1 à 2 Go pour le SAS seul (modèle Privacy Filter + images Docker
  des services de support) ;
- 20 Go pour le SAS + le Coffre-fort (le modèle de langage Mistral
  pèse à lui seul 15 Go) ;
- 22 à 25 Go pour le pack complet.

Sur fibre ou ADSL stable : 30 minutes à 2 heures. Sur connexion mobile
ou ADSL bas débit : prévoir une demi-journée. L'installation est
passive — vous n'avez pas besoin de rester devant l'écran.

---

## Étape 2 — Installer Docker Desktop (20 minutes)

Docker Desktop est l'environnement qui va héberger les composants
internes de L'IA du juriste, isolés du reste de votre système. Vous ne
manipulerez jamais Docker directement après installation : il tourne en
arrière-plan, signalé par une petite icône en forme de **baleine** dans
votre barre de tâches (Windows) ou votre barre de menu (macOS).

### 2.1 Télécharger Docker Desktop

Ouvrir votre navigateur web habituel (Chrome, Edge, Safari, Firefox)
et aller sur la page suivante en tapant l'adresse dans la barre
d'adresse :

```
https://www.docker.com/products/docker-desktop/
```

La page de Docker Inc. s'ouvre. Au centre de l'écran, vous voyez un
gros bouton bleu. Sous le bouton, plusieurs options sont proposées :

- « Download for Mac (Apple Silicon) » — si vous avez un Mac récent
  (M1, M2, M3, M4).
- « Download for Mac (Intel) » — si vous avez un Mac plus ancien à
  processeur Intel.
- « Download for Windows » — si vous êtes sur un PC sous Windows.

Cliquer sur le bouton qui correspond à votre machine.

**Si vous ne savez pas quel Mac vous avez :** pomme en haut à
gauche → « À propos de ce Mac » → la ligne « Puce » ou
« Processeur » indique « Apple M-quelque chose » (Apple Silicon) ou
« Intel Core » (Intel). En cas de doute, demandez à Claude (ou
faites une capture d'écran de la fenêtre « À propos de ce Mac »).

Un fichier d'environ 600 Mo s'enregistre dans votre dossier
« Téléchargements ».

### 2.2 Installer Docker Desktop sous Windows

1. Ouvrir votre dossier « Téléchargements ».
2. Double-cliquer sur le fichier `Docker Desktop Installer.exe`.
3. Windows demande confirmation (« Voulez-vous autoriser cette
   application à apporter des modifications à votre appareil ? »).
   Cliquer **Oui**.
4. Une fenêtre d'installation Docker s'ouvre. Deux cases à cocher :
   - **Use WSL 2 instead of Hyper-V** — laisser **cochée**
     impérativement.
   - **Add shortcut to desktop** — au choix.
5. Cliquer **OK** pour lancer l'installation.
6. Patienter 5 à 10 minutes.
7. À la fin, message « Installation succeeded », bouton **Close and
   restart**. Cliquer. Votre ordinateur redémarre.
8. Après redémarrage : menu Démarrer → taper « Docker Desktop » →
   cliquer.
9. Au premier lancement, Docker propose « Get started » ou
   « Sign in ». Cliquer **Skip** ou **Continue without signing in**.
   Vous n'avez pas besoin de compte Docker.
10. Docker démarre. Fenêtre principale ouverte. Au bout d'une minute,
    la mention « Engine running » apparaît en vert en bas à gauche.

**Si l'icône baleine n'apparaît pas après 2 minutes :** fermer Docker
Desktop (clic droit sur l'icône baleine dans la zone de notification
→ Quit Docker Desktop) puis relancer.

### 2.3 Installer Docker Desktop sous macOS

1. Ouvrir le dossier « Téléchargements ».
2. Double-cliquer sur `Docker.dmg`.
3. Glisser l'icône Docker sur le raccourci « Applications ».
4. Ouvrir le Launchpad (icône fusée), cliquer sur Docker.
5. macOS demande confirmation. **Ouvrir**.
6. Docker demande à installer un composant système. **OK**, puis
   mot de passe administrateur.
7. Premier lancement : « Skip » ou « Continue without signing in ».
8. Docker démarre. Icône baleine dans la barre de menu.

### 2.4 Allouer plus de mémoire à Docker (recommandé)

Important si vous installez le Coffre-fort ou le pack complet.
Skipable si vous n'installez que le SAS.

1. Dans Docker Desktop, engrenage en haut à droite.
2. Onglet **Resources** à gauche.
3. Curseur **Memory** : 16 Go (pour Coffre-fort) ou plus si vous
   avez beaucoup de RAM totale.
4. **Apply & restart**.

---

## Étape 3 — Installer Ollama (5 minutes)

À sauter si vous n'installez que le SAS et qu'aucune autre
fonctionnalité d'Ollama ne vous intéresse. Le SAS n'utilise pas Ollama
— en revanche le Coffre-fort et le MCP en dépendent.

### 3.1 Télécharger Ollama

Ouvrir le navigateur sur :

```
https://ollama.com/download
```

Cliquer sur le bouton correspondant à votre système. Un fichier
d'environ 700 Mo est téléchargé.

### 3.2 Installer Ollama sous Windows

1. Double-cliquer sur `OllamaSetup.exe`.
2. Cliquer **Install**.
3. Trente secondes plus tard, la fenêtre se ferme.
4. Une icône en forme de **lama** apparaît dans la zone de
   notification (en bas à droite, parfois cachée derrière une petite
   flèche `^`).

### 3.3 Installer Ollama sous macOS

1. Double-cliquer sur le fichier téléchargé.
2. Glisser l'icône Ollama dans Applications.
3. Ouvrir Ollama depuis le Launchpad.
4. Premier lancement : **Next** → **Install command line** → mot de
   passe administrateur.
5. Une icône en forme de lama apparaît dans la barre de menu.

### 3.4 Vérification d'Ollama (facultatif)

Si vous voulez vérifier, ouvrir le navigateur :

```
http://localhost:11434
```

Doit afficher : `Ollama is running`. Si pas, fermer Ollama (clic droit
sur l'icône lama → Quit) puis relancer.

---

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

URL du pack :

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

Un fichier `ia-juriste-v1.zip` (environ 500 Ko) est enregistré dans
votre dossier « Téléchargements ». Petit parce qu'il contient
seulement les scripts d'installation et la documentation. Le modèle
d'IA et les bases juridiques seront téléchargés ensuite par
l'installateur.

### 4.1 Extraire le pack

**Sous Windows :**

1. Explorateur → « Documents » → créer un nouveau dossier
   `IA-juriste` (clic droit → Nouveau → Dossier).
2. « Téléchargements » → clic droit sur `ia-juriste-v1.zip` →
   **Extraire tout…**.
3. **Parcourir** → naviguer jusqu'à `Documents\IA-juriste` →
   **Sélectionner un dossier**.
4. **Extraire**. Contenu extrait dans
   `Documents\IA-juriste\ia-juriste-v1\`.

**Sous macOS :**

1. Finder → « Documents » → créer dossier `IA-juriste`.
2. « Téléchargements » → double-clic sur `ia-juriste-v1.zip`. macOS
   extrait dans un dossier `ia-juriste-v1`.
3. Glisser ce dossier dans `Documents/IA-juriste/`.

---

## Étape 5 — Débloquer le dossier (Windows uniquement)

Si macOS, sauter à l'étape 6.

### 5.1 Ouvrir PowerShell administrateur

PowerShell est un outil de commande en ligne intégré à Windows. Vous
allez seulement copier-coller deux commandes.

1. Menu Démarrer → taper `powershell`.
2. **Clic droit** sur « Windows PowerShell » → **Exécuter en tant
   qu'administrateur** → **Oui** à l'UAC.

### 5.2 Coller la commande de déblocage

Sélectionner-copier (Ctrl+C) la commande suivante :

```
Get-ChildItem "$env:USERPROFILE\Documents\IA-juriste\ia-juriste-v1" -Recurse | Unblock-File
```

(Si vous avez extrait ailleurs, remplacer le chemin.)

Coller dans PowerShell (clic droit dans la fenêtre, ou Ctrl+V).
**Entrée**. Pas de message si succès.

### 5.3 Autoriser l'exécution des scripts

```
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned
```

**Entrée**. Si une question apparaît, taper `O` puis **Entrée**.

Fermer la fenêtre PowerShell administrateur.

---

## Étape 6 — Lancer l'installateur

### 6.1 Sous Windows

1. Explorateur → `Documents\IA-juriste\ia-juriste-v1\`.
2. **Clic droit** sur `installer.ps1` → **Exécuter avec PowerShell**.
3. Si SmartScreen alerte (« Cet éditeur n'a pas été vérifié »),
   **Informations complémentaires** → **Exécuter quand même**.
4. Une fenêtre PowerShell bleue s'ouvre, bandeau d'accueil.

### 6.2 Sous macOS

1. Finder → `Documents/IA-juriste/ia-juriste-v1/`.
2. **Clic droit dans la zone vide** à côté des fichiers → **Nouveau
   Terminal sur le dossier**.
3. Si l'option n'apparaît pas : Préférences Système → Clavier →
   Raccourcis → Services → Services de fichiers et de dossiers →
   cocher « Nouveau Terminal sur le dossier ».
4. Dans le Terminal : `bash installer.sh` puis Entrée.
5. Si bloqué (« installer.sh ne peut pas être ouvert ») :
   `xattr -d com.apple.quarantine installer.sh` puis relancer.

### 6.3 Répondre aux questions de l'installateur

L'installateur pose une dizaine de questions. Lire chaque question
avant de répondre.

**Question 1 — « Poursuivre l'installation ? »** → `O` Entrée.

**Question 2 — « Profil proposé : … . Accepter ce profil ? »**
Si cohérent avec vos modules désirés, `O`. Sinon `N` puis choisir
manuellement.

**Question 3 — « Installer le module SAS ? »** → `O` si oui.

**Question 4 — « Installer le module Coffre-fort RAG ? »** → `O`
si oui ET si votre RAM est ≥ 16 Go.

**Question 5 — « Installer le module MCP supervisé ? »** → `O` si
oui ET si votre RAM est ≥ 32 Go.

**Question 6 — Dossier des fichiers exportés** → Entrée (valeur par
défaut).

**Question 7 — OPENLEGI_TOKEN** *(si MCP coché)* → coller le jeton
si disponible, sinon Entrée. Le jeton pourra être ajouté plus tard
dans `.env`.

**Question 8 et 9 — PISTE_CLIENT_ID et PISTE_CLIENT_SECRET** *(si
Coffre-fort coché)* → idem.

### 6.4 Attendre les téléchargements

Durée variable :

- SAS seul : 5 à 15 minutes.
- SAS + Coffre-fort : 30 à 90 minutes (le modèle Mistral pèse 15 Go).
- Pack complet : 1 à 3 heures.

Vous pouvez laisser l'ordinateur travailler seul. Le message final
est :

```
Installation terminée.
Ouvrir Open WebUI : http://localhost:3000
```

L'installateur propose : « Ouvrir Open WebUI dans le navigateur ? ».
`O` Entrée.

---

## Étape 7 — Premier accès et création du compte (5 minutes)

À `http://localhost:3000`, créer un compte administrateur **local** :

- **Nom** : votre nom ou un alias.
- **E-mail** : adresse fictive acceptée (rien ne sera envoyé), par
  exemple `christophe@example.com`.
- **Mot de passe** : robuste.

Le compte est local. Cliquer **Create Account** ou **Sign Up**.

---

## Étape 8 — Configurer les Modèles personnalisés

L'installateur n'a pas pu configurer automatiquement les Modèles
personnalisés Open WebUI (limite de l'interface). C'est à vous de le
faire, en suivant le manuel correspondant à chaque module installé :

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

Compter 10 à 15 minutes par module. Suivre les manuels à la lettre.

**Si vous êtes perdu**, ouvrir `docs/installation_avec_claude.md`
dans Claude et lui demander de vous guider.

---

## Avertissements obligatoires à retenir

Trois règles non négociables :

### Règle 1 — Pseudonymisation : relecture humaine obligatoire

Avant de transmettre un document pseudonymisé à un assistant IA
distant, ouvrez la page de relecture
(`http://localhost:8082/review/<session>`), vérifiez chaque ligne,
corrigez les éventuels oublis. **Aucune transmission sans cette
relecture.**

### Règle 2 — Coffre-fort : relecture critique des conclusions

Le Coffre-fort retrouve correctement les sources mais peut raisonner
imparfaitement sur les pièges juridiques fins. Toujours relire
critiquement les conclusions sur les questions sensibles.

### Règle 3 — MCP supervisé : valider chaque appel sortant

Garder l'onglet `http://localhost:8001/queue` ouvert pendant les
sessions MCP, sinon vous raterez les demandes de validation.

---

## En cas de problème

Trois niveaux de diagnostic dans l'ordre :

1. **Consulter `docs/faq.md`** — couvre 80 % des cas.
2. **Redémarrer la stack** : Terminal / PowerShell dans `stack/` du
   pack :
   ```
   docker compose down
   docker compose up -d
   ```
3. **Demander à Claude** : ouvrir `docs/installation_avec_claude.md`
   dans Claude, lui décrire le problème, lui coller la capture du
   message d'erreur. Il diagnostiquera.

---

## Désinstaller L'IA du juriste

1. Terminal / PowerShell dans `Documents/IA-juriste/ia-juriste-v1/stack/`.
2. `docker compose down -v` puis Entrée.
3. Supprimer le dossier `Documents/IA-juriste/`.
4. Optionnellement, désinstaller Docker Desktop et Ollama via les
   utilitaires standard.

Aucun fichier n'est laissé hors du dossier `Documents/IA-juriste/`.