> ## Documentation Index
> Fetch the complete documentation index at: https://linkly.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.
# Guide d'installation hors ligne
> Installez Linkly AI et activez toutes les fonctions IA locales sur une machine sans internet (hors ligne / intranet) : téléchargez à l'avance l'installateur et le pack officiel de modèles, transférez-les, puis installez étape par étape.
La recherche, la reconnaissance de texte (OCR), la transcription vocale (ASR) et la recherche sémantique de Linkly AI **s'exécutent localement sur votre machine** : l'usage quotidien ne nécessite aucune connexion. Mais deux étapes du flux d'installation normal dépendent du réseau : le téléchargement de l'installateur, et le téléchargement automatique des fichiers de modèles IA (environ 870 Mo au total) au premier lancement.
Si la machine cible **n'a aucun accès à internet** (environnement hors ligne, intranet d'entreprise, réseau isolé), suivez cette page : téléchargez tout sur une machine connectée, transférez, puis installez.
Pour les fichiers de modèles, utilisez le pack officiel proposé sur cette page. **Ne téléchargez pas les fichiers de modèles depuis d'autres sources et ne reconstituez pas l'arborescence à la main** : les fichiers de modèles se corrompent facilement lors des transferts manuels et des ré-encodages, ce qui fait échouer les fonctions IA avec des erreurs déroutantes.
## Étape 1 : Que télécharger d'abord
Sur une machine **connectée à internet**, téléchargez ces deux éléments :
1. **L'installateur de l'application** : choisissez la plateforme de la machine cible (Windows / macOS / Linux) sur la [page de téléchargement officielle](https://linkly.ai/#get-started). La version **v0.9.0 ou ultérieure** est requise (les versions antérieures utilisent une autre arborescence de modèles, le pack hors ligne ne leur convient pas).
2. **Le pack officiel de modèles hors ligne** : un seul fichier zip, environ 850 Mo, contenant tous les modèles nécessaires à l'OCR, à la transcription vocale et à la recherche sémantique, ainsi qu'un fichier lisez-moi et une liste de sommes SHA-256.
3. **(Uniquement si la machine cible est sous Windows) deux installateurs de runtimes système** — hors ligne, l'installateur de l'application ne peut pas les récupérer automatiquement sur internet :
* [WebView2 Runtime (installateur autonome Evergreen, x64)](https://developer.microsoft.com/microsoft-edge/webview2/#download) : Windows 11 et la plupart des Windows 10 avec Edge l'ont déjà ; les systèmes d'entreprise allégés / LTSC peuvent en être dépourvus — emportez-le pour que l'installation ne reste pas bloquée
* [Microsoft VC++ 2015–2022 Redistributable (x64)](https://aka.ms/vs/17/release/vc_redist.x64.exe) : les composants IA locaux de l'application en dépendent ; s'il manque, l'installateur tente de le télécharger en ligne et échoue
linkly-ai-offline-models-20260825.zip · environ 850 Mo. Après téléchargement, conservez le zip tel quel — n'ouvrez et ne modifiez rien à l'intérieur.
## Étape 2 : Que copier sur la machine cible
Avec une clé USB, un disque externe ou un partage interne, copiez les deux fichiers **tels quels** sur la machine hors ligne (le bureau ou tout emplacement temporaire convient) :
* L'installateur de l'application (`.exe` / `.dmg` / `.AppImage`, etc.)
* Le zip du pack de modèles (**copiez le zip entier — ne l'extrayez pas pour copier les morceaux séparément**)
* (Windows) les installateurs des runtimes WebView2 et VC++
## Étape 3 : Comment installer
* **Windows** : installez **d'abord** le WebView2 Runtime puis le VC++ Redistributable (sur les machines qui les ont déjà, ils s'ignorent sans effet), **ensuite** double-cliquez sur l'installateur de l'application et suivez l'assistant
* **macOS** : ouvrez le `.dmg` et glissez Linkly AI dans le dossier Applications
* **Linux** : installez selon votre format de paquet (pour AppImage, rendez-le exécutable puis lancez-le)
Démarrez Linkly AI normalement une première fois — l'application crée automatiquement son dossier de données (hors ligne, sa tentative de téléchargement des modèles échouera ; ignorez cela). Puis fermez-la entièrement : clic droit sur l'icône L dans la barre d'état système, puis quitter.
Retrouvez-le selon votre système (créez-le s'il n'existe pas encore) :
Appuyez sur Win + R pour ouvrir « Exécuter », collez puis validez par Entrée :
```
%APPDATA%\ai.linkly.desktop\data
```
Dans le Finder, menu **Aller → Aller au dossier…** (⌘ + ⇧ + G), collez puis validez par Entrée :
```
~/Library/Application Support/ai.linkly.desktop/data
```
```bash theme={null}
mkdir -p ~/.local/share/ai.linkly.desktop/data
xdg-open ~/.local/share/ai.linkly.desktop/data
```
Vous pouvez aussi cliquer sur **Ouvrir** à côté de **Dossier de données** dans **Paramètres → À propos**, puis entrer dans `data/`.
Extrayez le zip du pack n'importe où : vous obtenez un dossier `models` (accompagné de deux fichiers d'information, `README.txt` et `SHA256SUMS.txt`). Copiez le **dossier `models` entier** dans le répertoire `data` ouvert à l'étape précédente — si `data` contient déjà un dossier `models`, fusionnez/écrasez.
Une fois terminé, la disposition finale doit correspondre exactement à l'[arborescence](#arborescence-après-installation) ci-dessous — par exemple, le fichier `data/models/Qwen3-Embedding-0.6B-Q8_0.gguf` doit exister.
Ouvrez Linkly AI puis **Paramètres → IA** : la section des modèles doit apparaître comme prête, et non en attente de téléchargement. L'OCR (reconnaissance de texte dans les scans/images) et la recherche sémantique fonctionnent immédiatement.
La transcription audio/vidéo est **désactivée par défaut** : au besoin, activez **Transcription audio** et **Transcription vidéo** dans **Paramètres → Index** — l'application traitera alors vos fichiers multimédias existants avec le modèle vocal fourni, sans nouvelle analyse.
## Arborescence après installation
Une fois en place, le dossier `data/models` doit contenir ceci (les noms de fichiers doivent correspondre exactement) :
```
models/
├── Qwen3-Embedding-0.6B-Q8_0.gguf ← modèle de recherche sémantique
├── ocr/
│ ├── .ready ← marqueur de disponibilité (fourni dans le pack ; n'y touchez pas)
│ ├── v6/
│ │ ├── pp-ocrv6_small_det.onnx
│ │ ├── pp-ocrv6_small_rec.onnx
│ │ ├── ppocrv6_dict.txt
│ │ ├── korean_pp-ocrv5_mobile_rec.onnx
│ │ ├── ppocrv5_korean_dict.txt
│ │ ├── latin_pp-ocrv5_mobile_rec.onnx
│ │ └── ppocrv5_latin_dict.txt
│ └── structure/
│ ├── pp-doclayout-m.onnx
│ ├── slanet_plus.onnx
│ └── table_structure_dict_ch.txt
└── asr/
└── sense-voice/
├── model.int8.onnx
└── tokens.txt
```
`ocr/.ready` est un fichier caché (son nom commence par un point) qui marque les modèles OCR comme prêts. **Ne l'ouvrez pas, ne le modifiez pas, ne le recréez pas** : les différences d'encodage introduites par les éditeurs de texte le feront rejeter par l'application. En cas de doute, réextrayez simplement le pack.
## Dépannage
Presque toujours une arborescence non conforme. Vérifiez point par point avec l'arbre ci-dessus, en particulier :
* Le zip a-t-il été extrait directement dans `data/models`, produisant un double niveau `data/models/models/...` ? Remontez le contenu du `models` intérieur d'un niveau
* La présence du fichier caché `ocr/.ready` (certains outils d'extraction ignorent par défaut les fichiers commençant par un point ; dans le Finder, ⌘ + ⇧ + . affiche les fichiers cachés)
* Le tout n'a-t-il pas atterri sur un autre lecteur ou dans le dossier d'un autre utilisateur ?
Le fichier a été corrompu pendant le téléchargement ou le transfert. Retéléchargez le pack et essayez une autre clé USB ou un autre mode de transfert. Le pack contient un `SHA256SUMS.txt` : les commandes de son `README.txt` permettent de vérifier chaque fichier et de localiser la casse. N'essayez ni réparation ni extraction partielle : des modèles corrompus provoquent des erreurs d'exécution bien plus difficiles à diagnostiquer.
Une nouvelle version a pu changer de modèles. Téléchargez le pack hors ligne le plus récent et remettez-le en place en suivant l'étape 3 de cette page.
Les anciennes versions utilisent une autre arborescence de modèles ; ce pack ne leur convient pas. Récupérez le dernier installateur en suivant les étapes 1 et 2, mettez l'application à jour, puis continuez.
## Ce qui fonctionne hors ligne
Ce pack couvre les **modèles IA locaux** — pas toutes les fonctionnalités. Une fois installé :
| Fonctionnalité | Disponibilité hors ligne |
| ----------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Indexation, recherche plein texte, lanceur, notes | ✅ Toujours disponible (aucun modèle requis) |
| Recherche sémantique, OCR, transcription audio/vidéo | ✅ Couvert par ce pack |
| Chat IA (Chatbot) | ❌ Repose sur des modèles cloud ; peut pointer vers un point de terminaison compatible OpenAI dans votre réseau (p. ex. Ollama / LM Studio sur le LAN) — voir la section fournisseurs personnalisés de [Service de modèles](/docs/fr/model-service) |
| Installation des Agent Skills | ❌ Nécessite un téléchargement internet ; ne fait pas partie de ce pack |
| Connexion au compte, bibliothèques cloud, mise à jour automatique | ❌ Fonctionnalités cloud |