Agentmemory

AGENTMEMORY : La Révolution de la Mémoire pour vos Agents de Codage

Dans l'écosystème du développement assisté par intelligence artificielle, la persistance et la pertinence des données sont cruciales. AGENTMEMORY se présente comme la couche de mémoire indispensable que votre agent de codage aurait dû posséder dès le premier jour. Conçu pour capturer chaque session et permettre un rappel en quelques millisecondes, AGENTMEMORY redéfinit la gestion du contexte pour les développeurs utilisant des outils comme Claude Code, Cursor ou Aider.

Qu'est-ce qu'AGENTMEMORY ?

AGENTMEMORY n'est ni une simple bibliothèque, ni une banale base de données vectorielle. Il s'agit d'un runtime de mémoire complet capable de capturer, rappeler, consolider, observer et fédérer les informations. Contrairement aux solutions traditionnelles, AGENTMEMORY fonctionne sans aucune base de données externe (Zero External Databases). Tout le runtime réside dans un seul processus Node.js, utilisant le moteur III pour transformer chaque opération de mémoire en un worker, une fonction ou un trigger.

Propulsé par une architecture qui élimine la "taxe de framework", AGENTMEMORY garantit que vos données restent locales tout en offrant des performances de pointe, notamment un score de récupération de 95,2% R@5 sur le benchmark LongMemEval-S et une réduction de 92% des jetons d'entrée par session.

Les Caractéristiques de AGENTMEMORY

Le système AGENTMEMORY repose sur trois primitives fondamentales et une suite d'outils intégrés qui automatisent la gestion du contexte.

1. La Pile Technologique (The Stack)

• Hooks Automatiques : 12 hooks capturent chaque appel d'outil, chaque invite et chaque arrêt pour les transformer en observations compressées.
• Rappel Triple-Flux : Une recherche hybride combinant BM25, la recherche vectorielle et un graphe de connaissances, reclassée directement sur votre appareil avec un P50 inférieur à 20ms.
• Consolidation : Des balayages horaires compressent les observations brutes en mémoires sémantiques, fusionnant les doublons et gérant l'obsolescence des données.

2. Un Écosystème Complet d'Outils

• 51 Outils MCP : Une interface native Model Context Protocol (MCP) incluant memory_save, memory_recall, et memory_smart_search.
• 121 Points de Terminaison REST : Chaque outil MCP possède un jumeau REST pour une intégration via Curl, navigateur ou proxy.
• Extraction de Graphe : Les entités et relations sont extraites lors de la compression pour une visualisation temporelle et relationnelle.
• Fédération Mesh : Synchronisation peer-to-peer entre nœuds AGENTMEMORY via HTTPS authentifié.
• Export Obsidian : Vos mémoires peuvent être exportées vers un coffre Obsidian sous forme de fichiers Markdown avec métadonnées.

3. Observabilité et Contrôle

AGENTMEMORY inclut nativement deux interfaces utilisateur :

• Viewer (Port 3113) : Un flux d'observation en temps réel pour visualiser les hooks, explorer les sessions et naviguer dans le graphe de connaissances.
• Console III (Port 3114) : Un tableau de bord technique pour surveiller les spans OTEL, l'état du processeur et les journaux système.

Cas d'Utilisation de AGENTMEMORY

L'implémentation de AGENTMEMORY transforme radicalement le flux de travail avec les agents IA :

• Développement Persistant : Utilisez AGENTMEMORY avec Claude Code ou Cursor pour que l'agent se souvienne des décisions architecturales prises lors des sessions précédentes.
• Réduction des Coûts LLM : Grâce à la compression sémantique, vous envoyez moins de jetons redondants à vos modèles (Claude, Gemini, etc.), optimisant ainsi votre consommation d'API.
• Analyse de Session (Replay) : Importez des transcriptions JSONL (comme celles de Claude Code) pour réhydrater une session complète et analyser le comportement de l'agent.
• Collaboration d'Agents : Grâce à la fédération Mesh, partagez des connaissances spécifiques entre différents agents ou machines de manière sécurisée.

Comparaison : AGENTMEMORY vs Le Marché

Basé sur les benchmarks LongMemEval-S, AGENTMEMORY surpasse les solutions existantes par sa simplicité et son efficacité :

| Fonctionnalité | AGENTMEMORY | Mem0 | Letta | Cognee | | :--- | :--- | :--- | :--- | :--- | | Récupération R@5 | 95,2% | 81,4% | 73,8% | 78.1% | | Dépendances Ext. | 0 | 2 (Qdrant, Neo4j) | 1 (Postgres) | 1 (Neo4j) | | Outils MCP | 51 | 12 | 18 | 9 | | Hooks Auto | 12 | 0 | 0 | 0 |

Comment utiliser AGENTMEMORY

L'installation et la configuration de AGENTMEMORY sont conçues pour être instantanées.

Étape 1 : Installation

Vous pouvez installer le package globalement via NPM :

npm install -g @agentmemory/agentmemory

Ou utiliser directement NPX sans installation permanente :

npx @agentmemory/agentmemory

Étape 2 : Démarrage du Serveur

Lancez le runtime de mémoire sur votre machine locale :

agentmemory

Le serveur fonctionnera sur le port 3111, et le visualiseur sera accessible sur le port 3113.

Étape 3 : Test de Performance

Pour valider la recherche hybride et voir la mémoire en action, lancez la démo :

agentmemory demo

Étape 4 : Connexion à un Agent

Pour connecter vos outils favoris (Claude Desktop, Cursor, Cline, etc.), utilisez la configuration MCP universelle :

{
  "mcpServers": {
    "agentmemory": {
      "command": "npx",
      "args": ["-y", "@agentmemory/mcp"],
      "env": {
        "AGENTMEMORY_URL": "http://localhost:3111"
      }
    }
  }
}

FAQ (Foire Aux Questions)

Q : AGENTMEMORY nécessite-t-il une base de données comme Redis ou Postgres ? R : Non. AGENTMEMORY fonctionne sans bases de données externes. L'état est géré sur le disque sous forme de fichiers JSON dans un seul processus Node.

Q : Quels fournisseurs de LLM sont supportés ? R : Par défaut, il utilise votre abonnement Claude, mais vous pouvez configurer l'API Anthropic, Gemini, MiniMax ou OpenRouter via vos variables d'environnement.

Q : Où sont stockées mes données ? R : Toutes les données restent locales sur votre machine. AGENTMEMORY privilégie la confidentialité et la souveraineté des données.

Q : Est-ce compatible avec les outils comme Cursor ou VS Code ? R : Oui, AGENTMEMORY propose des plugins natifs et une compatibilité via MCP pour Cursor, VS Code, Windsurf, et bien d'autres.

Note technique : AGENTMEMORY est un projet Open Source sous licence Apache-2.0, garantissant une transparence totale et une évolutivité communautaire.