Skip to main content
Ce guide de démarrage rapide vous permettra de construire votre première base de connaissances locale prête pour l’IA en quelques minutes, et de découvrir les fonctionnalités de base.
Envie de gagner du temps ? Laissez l’IA installer à votre place. Si vous disposez déjà d’un assistant IA capable d’exécuter des commandes — Claude Code, Codex, Cursor et consorts —, envoyez-lui la phrase ci-dessous : il lira le guide d’installation pour les Agents et vous accompagnera pas à pas dans l’installation, la configuration et la vérification — y compris pour les quelques étapes que vous devrez réaliser vous-même, qu’il vous expliquera clairement.
Bien entendu, poursuivre votre lecture convient tout aussi bien : cette page est un guide d’installation manuelle complet.

​
Avant de commencer

Linkly AI comprend les composants et fonctionnalités principaux suivants :

Linkly AI Desktop

Application de bureau (abrégée Linkly AI). Après l’installation, elle crée automatiquement l’index des documents et fournit des outils de recherche, de sommaire et de lecture.

Linkly AI CLI

Outil en ligne de commande permettant de se connecter à votre application Linkly AI depuis le terminal et d’appeler ses outils. Idéal pour les AI Agents.

MCP Server

Protocole ouvert pour l’obtention de contexte par les Agents. Après l’installation de Linkly AI, le service MCP démarre automatiquement, adapté aux appels des AI Agents.

linkly-ai-skills

Skills officiels pour les Agents, guidant l’Agent dans la connexion et l’utilisation des outils de Linkly AI. Fortement recommandé.

​
Étape 1 : Installer Linkly AI

Rendez-vous sur la page de téléchargement du site officiel et choisissez la version correspondant à votre système d’exploitation :

Télécharger Linkly AI

Choisissez la version adaptée à votre système d’exploitation
Ensuite, double-cliquez sur le programme d’installation. Voici les étapes pour chaque plateforme :
1

Ouvrir le programme d'installation

Double-cliquez sur le fichier .dmg téléchargé pour monter l’image disque
2

Glisser dans Applications

Faites glisser l’icône LinklyAI dans le dossier Applications
3

Lancer l'application

Trouvez LinklyAI dans le Launchpad ou le dossier Applications du Finder, puis double-cliquez pour lancer

​
Étape 2 : Initialiser Linkly AI

Lors du premier lancement de Linkly AI, une fenêtre d’accueil vous guide dans la configuration. Ensuite, vous ajoutez vos propres documents :
1

Suivre l'assistant de premier lancement

L’assistant comporte quatre écrans — couverture → Apportez vos fichiers → Connecter un agent → Tout est prêt (les indications « 1 / 2 » et « 2 / 2 » en bas à droite ne couvrent que les deux écrans du milieu). Sur chaque écran, deux petits boutons en bas à droite de la zone d’illustration permettent de changer à tout moment la langue et l’apparence.
  • Couverture : cochez J’ai lu et j’accepte la Politique de confidentialité — c’est obligatoire pour continuer. L’option de télémétrie Aider à améliorer Linkly AI (anonyme) est activée par défaut et peut être désactivée.
  • Apportez vos fichiers : les Fichiers d’exemple sont obligatoires ; ils sont décompressés et indexés en arrière-plan dès l’ouverture de l’assistant. En dessous figurent les dossiers système « Documents », « Bureau » et « Téléchargements », non cochés par défaut : cochez-en un et son indexation commence. Sous macOS, la première lecture de ces dossiers déclenche une demande d’autorisation du système ; si vous refusez, la ligne affiche « Non autorisé ».
  • Connecter un agent : cliquez sur Installer pour installer en arrière-plan la CLI Linkly et les Skills — sans ce clic, rien n’est installé ; « Garder la CLI et les Skills à jour » est activé par défaut. Cet écran propose aussi une instruction de configuration que vous pouvez envoyer telle quelle à votre agent.
  • Tout est prêt : cliquez sur Commencer pour terminer l’assistant et arriver sur l’accueil de la fenêtre principale. La liste en haut de l’accueil vous guide ensuite pour ajouter des dossiers, connecter un agent, etc.
L’assistant ne comporte aucune étape de connexion : l’indexation locale, la recherche locale et le service MCP fonctionnent tous sans compte. Pour utiliser les modèles d’IA officiels, connectez-vous dans Paramètres → Compte ; si vous n’êtes pas connecté et n’avez configuré aucun autre modèle, la page « Demander » vous invite à vous connecter.
2

Ajouter vos propres documents

Si vous n’avez coché aucun dossier pendant l’assistant, seuls les fichiers d’exemple sont indexés. Vos propres fichiers ne le sont pas encore. Si vous sautez cette étape, vos recherches ne remonteront jamais votre contenu réel.
Les deux méthodes suivantes fonctionnent :
  • Dans la barre latérale de la fenêtre principale, ouvrez Bibliothèque, cliquez sur « Ajouter un dossier » dans la colonne de gauche et choisissez les répertoires que vous souhaitez indexer — Documents, Téléchargements, un répertoire de projet, etc. ;
  • Ou déposez vos fichiers dans le dossier ~/LinklyAI. Il est surveillé par défaut : tout ce que vous y placez est indexé automatiquement.
Si le système signale des permissions insuffisantes (courant sous macOS), rendez-vous dans Réglages du système → Confidentialité et sécurité → Accès complet au disque, ajoutez Linkly AI, puis redémarrez l’application.
3

Connecter vos outils IA

Ajoutez le service MCP de Linkly AI à vos outils IA habituels pour activer la recherche documentaire intelligente.
Nous vous recommandons d’utiliser les Skills pour faciliter l’intégration. C’est la méthode la plus simple : copiez simplement le Prompt suivant dans votre assistant IA et suivez les instructions pour compléter l’intégration des outils et des Skills :

Veuillez installer l'Agent Skill linkly-ai-skills et...

Vous pouvez également intégrer manuellement les outils MCP, mais nous vous recommandons toujours d’installer les Skills pour une meilleure expérience :
Exécutez dans le terminal :
Le port 60606 est le port par défaut du service MCP de Linkly AI. Si la connexion échoue, vous trouverez le port réel sur la ligne « Serveur MCP : actif (port …) » du menu de la barre d’état système, ou dans la page « Utilisation par les agents » de la fenêtre principale, via « Voir la configuration de connexion MCP ».

​
Étape 3 : Première utilisation

Après le lancement, Linkly AI commence immédiatement à indexer vos documents et à les surveiller en continu. L’indexation complète prend entre quelques minutes et quelques dizaines de minutes (selon le nombre de documents et les performances de la machine).
Après le premier lancement, Linkly AI télécharge en arrière-plan environ 890 Mo de fichiers de modèles — environ 639 Mo pour la recherche sémantique et 249 Mo pour l’OCR. Selon votre connexion, cela peut prendre de quelques minutes à plus d’une heure.La recherche par mots-clés est utilisable immédiatement et n’est pas affectée. La recherche en langage naturel (sémantique) devient disponible une fois le téléchargement et l’indexation terminés.
Des enregistrements de réunion, des podcasts ou des vidéos de cours à retrouver ? La transcription vocale de l’audio et de la vidéo est désactivée par défaut : ces fichiers sont bien indexés et se retrouvent par leur nom, mais pas par ce qui s’y dit. Ouvrez la page Gestion de l’index (cliquez sur l’icône d’index en bas de la barre latérale gauche de la fenêtre principale, ou faites un clic droit sur l’icône de la barre d’état système et choisissez « Voir l’index »), puis activez Transcription audio et Transcription vidéo dans « Améliorations de l’extraction » : l’application rattrapera automatiquement les fichiers déjà présents. La description complète de chaque réglage d’indexation figure dans Paramètres d’indexation.
Vous pouvez utiliser LinklyAI de deux manières :

Rechercher des documents avec le lanceur

Utilisez le raccourci global ⌘ + L (Ctrl + L sous Windows / Linux) pour ouvrir la fenêtre du lanceur de recherche, puis saisissez des mots-clés ou une description en langage naturel pour trouver vos documents. Vous pouvez également faire un clic droit sur l’icône L de la barre d’état système et choisir Rechercher dans le menu (un clic gauche sur l’icône de la barre d’état ouvre la fenêtre principale). Si vous avez mis à jour depuis une ancienne version, votre raccourci précédent est conservé ; vous pouvez le vérifier dans Paramètres → Raccourcis.Vous pouvez également prévisualiser, consulter les métadonnées, ouvrir le document, copier le lien, etc. Pour plus d’informations, consultez la documentation du lanceur de recherche plein texte.

Utiliser avec un AI Agent

C’est la méthode que nous recommandons le plus. Vous bénéficierez d’une expérience d’interaction et d’une efficacité de recherche sans précédent.Après avoir complété l’intégration avec votre assistant IA ou installé les Skills, ajoutez simplement use linkly-ai après n’importe quel Prompt pour exploiter activement les puissantes capacités de recherche de Linkly AI.