Points clés
- Développé par le développeur indépendant HugoValim en tant que plugin communautaire open source — pas un produit officiel de Joplin
- Licence : MIT, selon le dépôt GitHub
- Connexion via un point de terminaison HTTP/SSE générique compatible OpenAI — sans SDK propriétaire — avec le port local par défaut d'Ollama (
http://localhost:11434/v1) comme URL de base par défaut - Fonctionne aussi avec LM Studio ou l'API OpenAI en changeant l'URL de base dans les paramètres
- Nécessite Joplin 3.6+ ; bureau uniquement — ne prend explicitement pas en charge Joplin mobile
- Chaque modification de note ou de fichier est affichée sous forme de document diff temporaire pour relecture avant application — rien n'est écrit silencieusement
- L'annulation conserve jusqu'à dix exécutions pendant sept jours ; la gestion de la concurrence repose sur une détection de conflit horodatée
- La recherche sémantique optionnelle sur les notes (RAG) nécessite Joplin 3.7+
📍 En une phrase
Joplin AI Agent est un plugin communautaire qui ajoute à Joplin un agent de chat IA soumis à relecture, se connectant à tout point de terminaison compatible OpenAI, y compris des serveurs Ollama et LM Studio entièrement locaux.
💬 En termes simples
Il ajoute dans Joplin un panneau de chat IA capable de lire vos notes et — seulement après votre approbation d'un diff affiché — de les modifier. Vous le connectez à un modèle tournant sur votre propre ordinateur via Ollama ou LM Studio plutôt qu'à un abonnement cloud, afin que vos notes puissent rester entièrement sur votre machine.
📌Remarque: Cette revue est le complément approfondi de la fiche de Joplin AI Agent dans le Local LLM Software Directory — consultez cette page pour voir en un coup d'œil comment il se compare à des dizaines d'autres outils IA locaux.
Qu'est-ce que Joplin AI Agent ?
Joplin AI Agent est un plugin communautaire pour Joplin, l'application de notes open source multiplateforme, développé par le développeur indépendant HugoValim et distribué en open source sous licence MIT. Selon son propre dépôt GitHub, il ajoute un agent IA avec accès en lecture et écriture, basé sur des outils, aux notes, carnets et fichiers texte d'un profil Joplin, chaque modification proposée passant par une étape de relecture avant application.
- Identifiant de plugin :
com.hugovalim.joplin-ai-agent - Version 0.7.0 au moment de cette revue — consultez le dépôt directement pour la version actuelle, celle-ci évoluant indépendamment de cet article
- Fonction principale : un agent de chat dans le panneau latéral capable de rechercher, lire et — après relecture — modifier notes, carnets et fichiers texte de votre profil Joplin
- Inférence locale : aucun moteur d'inférence intégré — le plugin envoie ses requêtes à un serveur compatible OpenAI exécuté séparément (Ollama, LM Studio ou une API cloud), plutôt que d'embarquer lui-même des poids de modèle
- Développeur : HugoValim, développeur indépendant distribuant le plugin en open source, sans lien avec les mainteneurs de Joplin
- Dépôt canonique : github.com/HugoValim/joplin-ai-plugin
Que peut faire Joplin AI Agent ?
Joplin AI Agent combine un chat conscient du vault, un accès aux fichiers basé sur des outils, et une étape de relecture avant toute écriture, selon son propre README.
- Historiques de chat persistants — les conversations conservent leurs paramètres de contexte et des résumés d'exécution d'une session à l'autre, au lieu d'être réinitialisées à chaque nouveau chat
- Recherche de notes optionnelle (RAG) — recherche sémantique dans vos notes pour que les réponses utilisent le contenu du vault comme contexte ; cette fonction précise nécessite Joplin 3.7 ou supérieur
- Règles anti-injection et anti-fabrication — le plugin documente des règles visant à empêcher l'injection de prompt via le contenu des notes et à réduire les citations fabriquées lorsque l'agent écrit à propos de vos notes
- Accès lecture/écriture basé sur des outils — l'agent peut lire et proposer des modifications aux notes, carnets et fichiers texte, pas seulement en discuter
- Propositions de modification soumises à relecture — toute modification proposée est affichée comme un document diff temporaire avant application, afin que vous approuviez ou rejetiez la modification exacte plutôt qu'elle ne soit écrite silencieusement
- Détection de conflit horodatée — le plugin vérifie les horodatages de modification des notes pour repérer les éditions concurrentes avant d'appliquer un changement
- Historique d'annulation — conserve jusqu'à dix exécutions pendant sept jours, afin qu'une mauvaise modification de l'agent puisse être annulée après coup
- Interface latérale avec raccourcis clavier — le panneau de chat vit dans le panneau latéral de Joplin avec des raccourcis clavier et pagine les longs historiques à 100 messages par page
- Prise en charge d'un espace de travail en dossier externe — peut travailler sur des fichiers dans un dossier externe au profil Joplin, en respectant le
.gitignorede ce dossier
Comment connecter Joplin AI Agent à un modèle local ?
Joplin AI Agent communique avec tout point de terminaison HTTP/SSE compatible OpenAI — aucun SDK propriétaire à configurer. L'URL de base par défaut, http://localhost:11434/v1, correspond au port de serveur local par défaut d'Ollama, si bien qu'une installation Ollama standard fonctionne sans aucune modification d'URL.
URL de base
Clé API
- Que saisir:
- Optionnelle pour la plupart des serveurs locaux ; requise pour les fournisseurs cloud qui l'exigent.
Nom du modèle
- Que saisir:
- L'identifiant exact du modèle tel que rapporté par votre backend (par exemple un tag de modèle Ollama déjà téléchargé).
Prompt système, température, tokens de sortie, délai
- Que saisir:
- Champs optionnels pour ajuster le comportement de l'agent — laissez les valeurs par défaut sauf raison précise de les modifier.
Toute la configuration se trouve sous Joplin Paramètres → « Joplin AI Agent ». Le plugin parlant un protocole générique compatible OpenAI plutôt qu'un SDK spécifique à un fournisseur, tout serveur local ou auto-hébergé exposant cette même forme d'API devrait fonctionner en changeant seulement l'URL de base.
Obtenir Joplin AI Agent
Joplin AI Agent s'installe comme un plugin à l'intérieur de Joplin, pas comme une application autonome — Joplin lui-même doit déjà être installé. Au moment de cette revue, il n'est pas confirmé que le plugin apparaisse dans la recherche intégrée des plugins communautaires de Joplin ; installez-le donc manuellement à partir du fichier .jpl publié sur GitHub Releases.
Installation manuelle depuis GitHub Releases (recommandé)
- Comment installer:
- Téléchargez
com.hugovalim.joplin-ai-agent.jpldepuis la page GitHub Releases. Dans Joplin, ouvrez Paramètres → Plugins, utilisez l'option « Installer depuis un fichier » et sélectionnez le fichier.jpltéléchargé. Redémarrez Joplin si demandé, puis activez le plugin s'il ne l'est pas déjà.
Compiler depuis les sources
- Comment installer:
- Clonez github.com/HugoValim/joplin-ai-plugin et suivez les instructions de build du dépôt — utile pour un commit précis ou pour contribuer.
Nécessite Joplin 3.6 ou supérieur. Joplin AI Agent fonctionne uniquement sur ordinateur — il ne prend explicitement pas en charge les applications mobiles de Joplin ; installez-le donc uniquement sur une instance Joplin de bureau (Windows, macOS ou Linux).
Comment Joplin AI Agent protège-t-il vos notes lors de l'écriture ?
Chaque modification de note ou de fichier proposée par Joplin AI Agent apparaît d'abord comme un document diff temporaire, pas comme une modification silencieuse. Vous relisez la modification exacte avant de décider de l'appliquer — l'agent n'écrase pas une note de lui-même.
- Écriture diff-first — une modification proposée s'affiche sous forme de document diff temporaire montrant exactement ce qui changerait, avant toute application à la vraie note
- Détection de conflit horodatée — le plugin vérifie l'horodatage de dernière modification d'une note avant d'appliquer un changement, pour repérer les cas où vous ou un autre appareil avez modifié la note après sa lecture par l'agent
- Fenêtre d'annulation — jusqu'à dix exécutions restent récupérables pendant sept jours, afin qu'une modification indésirable puisse être annulée après coup, pas seulement rejetée avant application
- Règles anti-injection et anti-fabrication — selon sa propre documentation, le plugin applique des règles visant à empêcher l'injection de prompt via le contenu des notes et à réduire les citations fabriquées lorsque l'agent référence vos notes
Qui devrait utiliser Joplin AI Agent ?
La pertinence de Joplin AI Agent dépend du fait que vous utilisiez déjà Joplin comme application de notes et souhaitiez un agent IA capable de lire et, après relecture, de modifier ce vault avec un backend que vous contrôlez.
Concurrents et alternatives
Joplin AI Agent est le plus directement en concurrence avec d'autres plugins d'agent IA conçus pour une application de notes spécifique plutôt qu'une interface de chat autonome. La comparaison PromptQuorum publiée la plus proche aujourd'hui concerne une autre application hôte.
- Copilot for Obsidian Review — un plugin d'agent IA de la même catégorie, mais pour Obsidian plutôt que Joplin. Il partage la même idée centrale (un agent IA qui lit et modifie votre vault de notes, avec prise en charge de modèles locaux), utile pour comparer comment deux applications de notes différentes abordent le même problème.
- Review de Smart Connections — un type d'outil différent dans la même catégorie plus large « IA dans votre application de notes » : un plugin de recherche sémantique et de découverte de liens local pour Obsidian, pas un agent qui modifie des fichiers.
Erreurs courantes lors de l'évaluation de Joplin AI Agent
La plupart des confusions autour de Joplin AI Agent viennent de l'hypothèse qu'il s'agit d'une fonctionnalité officielle de Joplin, ou de l'attente qu'il fonctionne sur mobile comme sur ordinateur.
Questions fréquemment posées
Qu'est-ce que Joplin AI Agent ?
Joplin AI Agent est un plugin développé par la communauté pour l'application de notes Joplin, ajoutant un agent de chat IA avec accès en lecture et, après relecture, en écriture à vos notes, carnets et fichiers texte. Il est développé indépendamment par HugoValim.
Joplin AI Agent fonctionne-t-il avec des modèles IA locaux ?
Oui. Il se connecte à tout point de terminaison HTTP/SSE compatible OpenAI, et son URL de base par défaut (http://localhost:11434/v1) correspond au serveur local d'Ollama, ce qui lui permet de fonctionner avec un modèle entièrement local sans modification de code. Il fonctionne aussi avec LM Studio ou un autre serveur compatible OpenAI en changeant simplement l'URL de base.
Joplin AI Agent est-il fait par l'équipe de Joplin ?
Non. C'est un plugin communautaire indépendant développé et maintenu par HugoValim, ni développé ni officiellement soutenu par les mainteneurs de Joplin.
Sous quelle licence Joplin AI Agent est-il publié ?
MIT, selon le dépôt GitHub du plugin à github.com/HugoValim/joplin-ai-plugin.
Comment installer Joplin AI Agent ?
Téléchargez le fichier com.hugovalim.joplin-ai-agent.jpl depuis la page GitHub Releases du plugin, puis dans Joplin ouvrez Paramètres → Plugins et utilisez « Installer depuis un fichier » pour le sélectionner. Il n'est pas confirmé qu'il soit recherchable dans le marketplace intégré de Joplin, cette installation manuelle est donc le chemin documenté.
Joplin AI Agent fonctionne-t-il sur Joplin mobile ?
Non. Le plugin ne prend explicitement pas en charge Joplin mobile — il fonctionne uniquement sur ordinateur, pour les installations Windows, macOS et Linux de Joplin.
Quelle version de Joplin Joplin AI Agent nécessite-t-il ?
Joplin 3.6 ou supérieur pour le plugin lui-même. Sa fonction optionnelle de recherche de notes (RAG) nécessite spécifiquement Joplin 3.7 ou supérieur.
Joplin AI Agent modifie-t-il mes notes automatiquement ?
Non. Chaque modification proposée est affichée comme un document diff temporaire à relire avant application — l'agent n'écrit pas silencieusement dans une note.
Puis-je annuler une modification faite par Joplin AI Agent ?
Oui. Le plugin conserve jusqu'à dix exécutions pendant sept jours, ce qui permet d'annuler une modification récente de l'agent après coup.
Quels backends IA Joplin AI Agent prend-il en charge ?
Selon sa propre documentation, tout point de terminaison HTTP/SSE compatible OpenAI — cela inclut Ollama (par défaut), LM Studio et l'API OpenAI, car il utilise un format d'API générique plutôt qu'un SDK propre à un fournisseur.