Modèle / jeu de données
lucasastorian/llmwiki avatar
lucasastorian/llmwiki

LLM Wiki : un wiki personnel que Claude entretient à votre place

Open Source Implementation of Karpathy's LLM Wiki. Upload documents, connect your Claude account via MCP, and have it write your wiki !

1 611 étoiles234 forksPythonApache-2.0

En bref

De quoi s’agit-il ?
LLM Wiki indexe un dossier de documents, expose le tout à Claude via MCP et laisse une routine planifiée réécrire les pages. L'idée est bonne, mais elle repose entièrement sur la qualité de vos sources et sur la discipline de votre configuration MCP.
À qui s’adresse-t-il ?
LLM Wiki convient à celles et ceux qui accumulent déjà des PDF, notes et extraits web dans un dossier et qui veulent une couche de synthèse entretenue par Claude, sans déplacer leurs fichiers. Il ne convient pas si vous cherchez un RAG interrogeable en direct, si vous refusez de dépendre d'un compte Claude, ou si vos sources sont déjà structurées et versionnées.
Puis-je l’utiliser commercialement ?
Oui. Apache-2.0 est une licence permissive : vous pouvez utiliser, modifier et vendre un logiciel qui en dépend, à condition de conserver les mentions de droit d’auteur et de licence.
Est-il encore maintenu ?
Oui. Les derniers commits datent d’il y a 5 jours.
En quel langage est-il écrit ?
Principalement Python, d’après les statistiques de langage de GitHub.

Ces réponses reposent sur les données GitHub du projet (dernière synchronisation le 15 septembre 2026) et sur notre analyse. Elles ne constituent pas un avis juridique.

ANALYSE OPEN SOURCE APPROFONDIE

Le problème visé : des lectures qui ne laissent aucune trace exploitable

La plupart des gens lisent beaucoup et retiennent peu. Les PDF s'empilent, les notes restent dans une application, les surlignages disparaissent avec l'onglet. Le README part d'un constat simple : le savoir-faire vit dans la tête des gens, pas dans un document consultable. LLM Wiki vise trois publics distincts, et le README les nomme explicitement : l'individu qui veut une encyclopédie personnelle de ses lectures, l'assistant IA qui a besoin d'un contexte stable pour appliquer vos propres modèles mentaux, et l'organisation qui souffre d'une mémoire institutionnelle défaillante. Le troisième cas est le plus intéressant et le plus fragile. Rien dans le dépôt ne montre un mécanisme de gestion des droits, de validation ou de conflits entre plusieurs auteurs. Le README formule un espoir, pas une fonctionnalité livrée. C'est une direction, pas une capacité vérifiée.

Ce qui se passe sur le disque, et pourquoi c'est le point central

Le choix d'architecture le plus lourd de conséquences est celui-ci : LLM Wiki ne déplace ni ne modifie vos fichiers. Il pointe vers un dossier existant et y ajoute deux choses, un dossier wiki/ pour les pages générées et un dossier caché .llmwiki/ pour l'index. Le README insiste sur ce point et précise que les fichiers ne sont ni déplacés ni envoyés. C'est une contrainte forte qui explique tout le reste. L'indexation construit une couche de recherche locale au-dessus de vos documents, et c'est cette couche que Claude interroge. Le mécanisme de recherche lui-même n'est pas détaillé dans le matériel fourni : on sait qu'un index local existe, on ne sait pas quelle bibliothèque l'implémente ni comment les embeddings sont calculés. Toute personne qui doit justifier un choix technique en entreprise devra ouvrir le code pour répondre à cette question. Le mode local est volontairement limité à la boucle locale : l'API écoute sur 127.0.0.1 et le README indique clairement l'absence de support pour une liaison LAN ou distante. Ce n'est pas un oubli, c'est une décision de périmètre.

Mise en route : les commandes réelles

L'installation demande Python 3.11 ou plus et Node.js 20 ou plus. LibreOffice est optionnel et sert à extraire les fichiers Word et PowerPoint. Une clé MISTRAL_API_KEY est également optionnelle, présentée comme un moyen d'obtenir un OCR de meilleure qualité sur les PDF. Sur macOS ou Linux, la séquence est : git clone du dépôt, création d'un environnement virtuel, puis pip install -r api/requirements.txt -r mcp/requirements.txt, et enfin npm install dans web/. Sous Windows, le README donne la variante PowerShell, avec une note utile sur les politiques d'exécution : si l'activation est bloquée, il faut soit autoriser les scripts signés localement, soit appeler directement .venv\Scripts\python. Une fois installé, la commande ./llmwiki open ~/research initialise l'espace de travail, indexe le dossier, démarre l'API et l'application web, puis ouvre localhost:3000. Pour brancher Claude, on lance ./llmwiki mcp-config ~/research et on colle le JSON affiché dans claude_desktop_config.json ou dans .claude/settings.json. Le README précise qu'un espace de travail correspond à une entrée de serveur MCP, donc une entrée par dossier. Ce détail compte : si vous avez déjà des serveurs MCP configurés, vous fusionnez des objets JSON, vous ne remplacez pas le fichier.

La routine planifiée : le vrai différenciateur, et le vrai risque

Sans automatisation, LLM Wiki serait un dossier indexé de plus. Ce qui le distingue, c'est la routine planifiée. Le README fournit un prompt qui fonctionne bien selon lui : demander à Claude de lire le guide, de trouver tout ce qui a été ajouté depuis la dernière exécution, puis de mettre à jour le wiki en créant des pages, en intégrant le nouveau matériel dans les pages existantes et en corrigeant les renvois et citations affectés. Ce prompt est ensuite planifié pour tourner chaque nuit. Deux mécanismes sont proposés : les routines Claude Code, qui s'exécutent sur l'infrastructure d'Anthropic à cadence fixe même ordinateur fermé, ou une tâche planifiée de bureau, qui tourne sur votre machine. La différence est opérationnelle, pas cosmétique. Une routine cloud suppose que votre dossier de travail soit accessible depuis le cloud, ce qui n'est pas décrit dans le matériel fourni. Une tâche locale dépend de votre machine allumée. Dans les deux cas, une écriture automatisée modifie le contenu de wiki/ sans relecture humaine par défaut. Si une source est mal extraite, l'erreur se propage dans les pages et dans les renvois.

Capturer ce que vous pensez, pas seulement ce que vous lisez

L'extension Chrome est l'élément le plus original du projet. Elle permet de découper des pages web et des PDF, de surligner des passages et de laisser des commentaires. Le README insiste sur le fait que Claude voit ces commentaires via MCP. L'argument est que le wiki devient un enregistrement non seulement de ce que vous avez lu, mais de ce que vous en avez pensé. C'est une distinction réelle : la plupart des outils de capture conservent le texte source, très peu conservent la réaction immédiate. En pratique, cela déplace la charge de travail. Le wiki ne peut refléter vos modèles mentaux que si vous annotez au moment de la lecture. Une bibliothèque de PDF sans commentaires produit un wiki de résumés, pas un wiki de jugements. Le README ne décrit ni la robustesse de l'extension sur des pages complexes, ni la façon dont les commentaires sont rattachés à un passage précis après modification de la page source. Ce sont des zones grises à tester avant de s'engager.

Ce que le projet ne fait pas

La limite la plus nette concerne la nature de la recherche. LLM Wiki indexe des documents et les rend lisibles par Claude, mais l'unité de travail reste le document. Si votre besoin est de poser une question et d'obtenir une réponse synthétisée à partir de dizaines de sources hétérogènes, avec citation des passages pertinents, vous êtes dans le territoire d'un système RAG classique. Un pipeline construit avec LlamaIndex ou Haystack découpe vos documents en fragments, calcule des vecteurs, et interroge une base vectorielle à la question. LLM Wiki ne décrit pas ce découpage en fragments. Il construit des pages de wiki. La différence est structurelle : un RAG répond à une question ponctuelle, un wiki accumule une position. L'autre limite est la dépendance à Claude. Le README mentionne Codex et d'autres applications compatibles MCP, mais toute la boucle de maintenance repose sur un compte Claude et sur les routines. Sans ce compte, il reste une application web locale et un index. Enfin, le mode local est verrouillé sur 127.0.0.1, donc un accès depuis une autre machine du réseau n'est pas pris en charge.

Coût de maintenance et licence

Le projet est publié sous Apache-2.0. Cette licence autorise l'usage commercial, la modification et la redistribution, à condition de conserver les mentions de copyright et le fichier de licence, et elle inclut une concession de brevet de la part des contributeurs. Elle ne donne aucune garantie. Le matériel fourni ne contient aucune version publiée, aucune étiquette de version, et le README ne décrit pas de procédure de mise à jour ni de politique de compatibilité. Concrètement, cela signifie que suivre le dépôt implique de relire les changements avant de tirer. Deux fichiers de dépendances sont à surveiller, api/requirements.txt et mcp/requirements.txt, plus le paquet npm du dossier web/. Le coût réel n'est pas l'installation, qui tient en quelques commandes, mais la configuration MCP par dossier et la surveillance des écritures automatiques dans wiki/. Un wiki qui se réécrit chaque nuit sans relecture dérive, et le README ne propose aucun mécanisme de comparaison entre deux versions d'une page.

Conclusion éditoriale

LLM Wiki convient à celles et ceux qui accumulent déjà des PDF, notes et extraits web dans un dossier et qui veulent une couche de synthèse entretenue par Claude, sans déplacer leurs fichiers. Il ne convient pas si vous cherchez un RAG interrogeable en direct, si vous refusez de dépendre d'un compte Claude, ou si vos sources sont déjà structurées et versionnées. Avant d'adopter, vérifiez trois choses concrètes : que le dossier choisi contient bien vos documents définitifs, que le JSON produit par ./llmwiki mcp-config s'insère dans votre fichier de configuration MCP existant sans écraser d'autres serveurs, et que la routine planifiée est autorisée à écrire dans le dossier wiki/ sans conflit avec votre propre versionnage.

Sources officielles

  1. Issues
  2. License: Apache-2.0
  3. lucasastorian/llmwiki on GitHub
  4. Project website
  5. README
Notes de la communauté

Notes de la communauté