basic-memory: lire AI conversations that actually remember
Des conversations IA qui se souviennent réellement. Ne réexpliquez plus jamais votre projet à votre IA. Rejoignez notre Discord :.
En bref
- De quoi s’agit-il ?
- AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:.. Analyse pratique du périmètre, des composants et des limites documentés.
- À qui s’adresse-t-il ?
- basicmachines-co/basic-memory s’adresse aux personnes dont le besoin correspond exactement à ce que le README décrit et qui peuvent contrôler Python dans leur environnement. Il convient moins à qui attend un support ou une garantie non écrite.
- Puis-je l’utiliser commercialement ?
- Oui, sous conditions strictes. AGPL-3.0 est une licence à copyleft réseau : si des personnes utilisent une version modifiée via un réseau, par exemple comme service hébergé, vous devez leur proposer son code source sous la même licence.
- Est-il encore maintenu ?
- Oui. Le dépôt a reçu de nouveaux commits au cours des dernières 24 heures.
- 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
Une couche mémoire Markdown pour les assistants IA
Basic Memory est un projet Python qui stocke les connaissances accessibles à l'IA sous forme de fichiers Markdown en texte brut sur votre disque. Le README le décrit comme un moyen pour les assistants IA de se souvenir du contexte entre les sessions, l'utilisateur et l'IA lisant et écrivant les mêmes fichiers. Il utilise le protocole de contexte de modèle (MCP) pour se connecter à des clients comme Claude, Codex, Cursor et ChatGPT. Le projet se présente comme local-first, avec synchronisation bidirectionnelle, un graphe de connaissances construit à partir de wikilinks et d'observations, et une recherche sémantique. Les métadonnées du dépôt affichent 3 584 étoiles et 248 forks, mais le README ne fournit pas de statistiques d'utilisation.
Dans le dépôt basicmachines-co/basic-memory, ce point 1 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 1, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: la structure et le point d’entrée documenté. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 1, plutôt qu’une promesse générale.
Deux chemins de déploiement : cloud hébergé ou installation locale
Le README présente deux façons d'exécuter Basic Memory. La version cloud est un service hébergé qui fonctionne dans un navigateur, inclut la synchronisation multi-appareils, les sauvegardes et les instantanés, et coûte 15,00 $ par mois avec un essai gratuit de 7 jours. L'installation locale est gratuite sous AGPL-3.0, fonctionne entièrement sur votre disque et nécessite Python via uv. Les deux chemins utilisent les mêmes fichiers Markdown et les mêmes outils MCP. Le README indique que le cloud est facultatif et que vous pouvez passer de l'un à l'autre. Il ne précise aucune limitation du service cloud au-delà des détails de prix.
Dans le dépôt basicmachines-co/basic-memory, ce point 2 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 2, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: la commande ou la configuration citée. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 2, plutôt qu’une promesse générale.
Entités, observations et relations en Markdown
Basic Memory définit une grammaire simple pour les fichiers de connaissances. Chaque fichier est une entité avec un frontmatter contenant un titre, un type, un permalien et des balises facultatives. Le corps contient des observations (des faits avec des catégories, des balises ou un contexte facultatifs) et des relations (des liens de style wiki vers d'autres entités). Le README donne un exemple de note sur les méthodes de préparation du café, montrant comment l'IA crée un fichier structuré à partir d'une conversation. Les relations utilisent des types à un seul jeton ou des types à plusieurs mots entre guillemets, et les liens nus sont indexés comme links_to. Selon le README, c'est toute la grammaire.
Dans le dépôt basicmachines-co/basic-memory, ce point 3 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 3, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: les données, composants ou dépendances explicitement listés. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 3, plutôt qu’une promesse générale.
Outils MCP et connexions clientes
Basic Memory expose un ensemble d'outils MCP que tout client MCP peut appeler. Le README répertorie des outils pour le contenu (écrire, lire, éditer, déplacer, supprimer), la recherche et la découverte, la construction de contexte de graphe de connaissances, la gestion de projets, les opérations de schéma et le diagnostic de compatibilité. Chaque outil porte des indices de comportement tels que lecture seule, destructif, idempotent et monde ouvert, ce qui, selon le README, aide les agents à choisir le bon outil sans essais et erreurs. Le README inclut également des extraits de configuration pour Claude Desktop, Claude Code, Codex CLI, Cursor, VS Code et ChatGPT, et note qu'Obsidian peut lire directement le même Markdown sans configuration.
Dans le dépôt basicmachines-co/basic-memory, ce point 4 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 4, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: le comportement annoncé dans le README. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 4, plutôt qu’une promesse générale.
Installer et connecter une instance locale
Pour une utilisation locale, le README recommande d'installer via uv avec la commande `uv tool install basic-memory`. Pour les déploiements Postgres stockant des vecteurs sémantiques dans Milvus, il existe un extra facultatif : `uv tool install "basic-memory[milvus]"`. Après l'installation, vous configurez votre client MCP en ajoutant une entrée de serveur qui exécute `uvx basic-memory mcp`. Le README montre des extraits JSON ou TOML pour Claude Desktop, Claude Code, Cursor, VS Code et Codex. Il note également que les notes sont stockées dans `~/basic-memory` par défaut. Le README ne spécifie pas d'exigences matérielles minimales ni de systèmes d'exploitation pris en charge, sauf qu'il mentionne macOS, Windows et Linux pour Claude Desktop.
Dans le dépôt basicmachines-co/basic-memory, ce point 5 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 5, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: les limites et prérequis indiqués. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 5, plutôt qu’une promesse générale.
Mises à jour automatiques, recherche sémantique et outils de schéma
Le README met en évidence plusieurs ajouts récents. Les mises à jour automatiques vérifient toutes les 24 heures pour les installations uv tool et Homebrew, avec une commande manuelle `bm update`. La recherche vectorielle sémantique est disponible avec un classement hybride texte intégral et vecteur, utilisant les embeddings FastEmbed sur SQLite ou Postgres. Un réordonnanceur à encodeur croisé facultatif peut réévaluer les candidats, désactivé par défaut pour éviter la latence et les téléchargements de modèles. Le système de schéma fournit les outils `schema_infer`, `schema_validate` et `schema_diff`. La CLI a été refondue avec une sortie `--json` et un tableau de bord de projet. Le README renvoie à un journal des modifications pour v0.18 à v0.20.
Dans le dépôt basicmachines-co/basic-memory, ce point 6 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 6, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: la version, le statut ou l’historique publié. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 6, plutôt qu’une promesse générale.
Politique de télémétrie et licence AGPL-3.0
Selon le README, Basic Memory collecte des événements anonymes minimaux pour comprendre l'entonnoir de conversion de la CLI vers le cloud. Il ne collecte explicitement pas le contenu des fichiers, les titres de notes, les données de la base de connaissances, les informations personnelles, les adresses IP ou le suivi par commande. Les événements sont envoyés à une instance Umami Cloud sur un thread d'arrière-plan et peuvent être désactivés avec la variable d'environnement `BASIC_MEMORY_NO_PROMOS=1`. Le projet est sous licence AGPL-3.0, et l'extrait de licence explique qu'il exige des opérateurs de serveurs réseau qu'ils fournissent le code source des versions modifiées aux utilisateurs. Le README ne contient aucune garantie ni engagement de sécurité, et le texte de la licence déclare qu'il n'y a aucune garantie pour l'œuvre.
Dans le dépôt basicmachines-co/basic-memory, ce point 7 doit être lu avec les éléments réellement nommés par le README. La description du projet indique « AI conversations that actually remember. Never re-explain your project to your AI again. Join our Discord:. ». Elle fixe un périmètre, mais ne prouve ni une compatibilité universelle ni une disponibilité durable. La lecture utile consiste à relier cette section à un fichier, une commande, une classe ou une liste précise de basicmachines-co/basic-memory. Les détails absents des sources restent non établis.
Pour vérifier ce passage 7, partez de basicmachines-co/basic-memory et observez le résultat propre à ce dépôt: les fichiers de contribution et la licence. Une équipe peut ainsi distinguer ce que basicmachines-co/basic-memory fournit de ce qu’elle devra ajouter elle-même. Le README est suffisamment précis pour orienter un premier essai, toutefois il ne remplace pas l’examen des versions, des permissions et des entrées propres au contexte visé.
Le choix dépend donc du rôle attendu pour basicmachines-co/basic-memory. Il peut convenir à une expérimentation ciblée lorsque l’équipe maîtrise Python et accepte les conditions écrites. Il convient moins à un usage qui exige une garantie que le dépôt ne formule pas. Conservez l’observation liée à basicmachines-co/basic-memory et au repère 7, plutôt qu’une promesse générale.
Conclusion éditoriale
basicmachines-co/basic-memory s’adresse aux personnes dont le besoin correspond exactement à ce que le README décrit et qui peuvent contrôler Python dans leur environnement. Il convient moins à qui attend un support ou une garantie non écrite. Avant l’adoption, exécutez le scénario propre à basicmachines-co/basic-memory, inspectez les fichiers cités et comparez la sortie attendue avec celle obtenue.
Notes de la communauté