Mémoire locale pour agents IALocal memory for AI agents

Tes agents oublient.
Lorag se souvient. Your agents forget.
Lorag remembers.

Un démon local qui indexe tes fichiers et garde ce que tes agents ont déjà trouvé ou appris. Ils le retrouvent en quelques tokens, par MCP, au lieu de chercher à nouveau. A local daemon that indexes your files and keeps what your agents already found or learned. They get it back in a few tokens, over MCP, instead of searching again.

brew install raucheacho/tap/lorag

brew services start lorag

curl -fsSL https://raw.githubusercontent.com/raucheacho/lorag/main/scripts/install.sh | sh -s -- --service

git clone https://github.com/raucheacho/lorag && cd lorag && make build

Voir le codeView source Guide d'utilisationUser guide

~/code/shoplocalhost:8080

$ npm run dev
Error: listen EADDRINUSE: address already in use :::3000

$ loragctl mem recall "listen EADDRINUSE :::3000"
[ece4650cdd-1] +4/-0 2026-10-02
Fix: lsof -ti :3000 | xargs kill -9
Ctx: node@22
# déjà résolu le 2 octobre, rappelé en quelques tokens# solved on October 2, recalled in a few tokens

# MCP search · "pénalités de retardlate penalties"
[1] ~/docs/contrat-fournisseursupplier-contract.pdf p. 12
[2] ~/reunionsmeetings/2026-10-03.m4a 14:32-14:58
[3] ~/docs/conditionsterms.docx L40-52

20–60tokens par rappeltokens per recall

1binaire, Studio inclusbinary, Studio included

0service cloud nécessairecloud services needed

7outils MCPMCP tools

01 · fonctionnementhow it works

De tes fichiers à tes agents.From your files to your agents.

Lorag tourne en fond avec ta session. Il lit tes dossiers, les découpe, les indexe dans son moteur, puis répond à tes agents sur localhost.Lorag runs in the background with your session. It reads your folders, splits them, indexes them in its engine, then answers your agents on localhost.

sources

Tes dossiersYour folders

Surveillés : un fichier modifié est réindexé, un fichier inchangé est ignoré.Watched: a changed file is reindexed, an unchanged one is skipped.

pdfmdcodedocxpptxxlsxm4amp4png

extractionextraction

Texte et positionsText and positions

Chaque morceau garde sa page, ses lignes ou sa minute.Each chunk keeps its page, lines or minute.

popplerwhisper.cppffmpegtesseract

index

VectixDB

Moteur en Zig lié au démon. Embeddings et BM25 fusionnés, résiste aux plantages.Zig engine linked into the daemon. Embeddings and BM25 fused, crash safe.

Ollama · bge-m3BM25

mcp · localhost:8080

Tes agentsYour agents

Tout client MCP en HTTP, et le Studio pour voir ce qu'ils demandent.Any MCP client over HTTP, and the Studio to see what they ask.

Claude CodeCursorVS CodeCodex

Recherche hybrideHybrid search

Un message d'erreur se retrouve mot pour mot, une idée par son sens.An error message is found word for word, an idea by its meaning.

Au bon endroitRight on the spot

Chaque résultat renvoie à la page d'un PDF, aux lignes d'un fichier ou à la minute d'un audio ou d'une vidéo.Each result points to a PDF page, the lines of a file or the minute of a recording.

Rien ne sortNothing leaves

Embeddings, transcription et OCR tournent en local. Aucune donnée ne sort sans ton action.Embeddings, transcription and OCR run locally. No data leaves without your say.

02 · mémoirememory

Rappeler, garder, noter.Recall, keep, rate.

Tes agents reçoivent ces règles à la connexion. Ce qu'ils apprennent sert à tous les autres.Your agents get these rules when they connect. What one learns, the others reuse.

Rappeler d'abordRecall first
Sur une erreur, avant le web, ou avant de répondre sur toi : memory_recall.On an error, before the web, or before answering about you: memory_recall.
Garder ce qui est vérifiéKeep what is verified
Un correctif, une réponse avec sa source, un fait sur toi ou tes proches : memory_save.A fix, an answer with its source, a fact about you or people you know: memory_save.
Dire si ça a marchéSay if it worked
Les bonnes entrées remontent, les fausses sont à revérifier puis retirées : memory_feedback.Good entries rise, wrong ones go to recheck then retire: memory_feedback.

memory_recallhit · 38 tokens

{ "error": "Error: Cannot find module 'metro-runtime'",
  "project": "shop", "context": { "expo": "52.0.1" } }

[3f2a9c41b7-1] +3/-0 2026-10-12
Fix: npx expo start -c
Ctx: expo@52

memory_saveknowledge

{ "kind": "knowledge",
  "problem": "GitHub REST API rate limit",
  "solution": "5,000 requests per hour per user",
  "source": "https://docs.github.com/en/rest/rate-limit" }

memory_savefact

{ "kind": "fact",
  "problem": "Qui est Karim ?Who is Karim?",
  "solution": "Associé de l'utilisateur depuis 2024The user's business partner since 2024" }

memory_feedbackverified

{ "id": "3f2a9c41b7-1", "worked": true }

03 · dans le binairein the binary

Tout ce qu'il faut, rien à héberger.Everything you need, nothing to host.

Un seul exécutable pour macOS et Linux : le démon, le moteur, le Studio et la CLI.A single executable for macOS and Linux: the daemon, the engine, the Studio and the CLI.

Studio

Vois ce que tes agents demandent, teste une requête, comprends pourquoi un résultat sort et corrige la mémoire.See what your agents ask, test a query, understand why a result comes up and fix the memory.

Historique et sourcesHistory and sources

Chaque entrée garde sa source, ses versions et ses révisions. Un fait qui change remplace l'ancien sans l'effacer.Every entry keeps its source, versions and revisions. A fact that changes replaces the old one without erasing it.

Secrets masquésSecrets masked

Clés d'API, jetons et mots de passe sont masqués avant l'écriture. Mémoire et documents restent des données, jamais des ordres.API keys, tokens and passwords are masked before writing. Memory and documents stay data, never instructions.

loragctl

Indexer, chercher, rappeler et enregistrer depuis le terminal ou un script. Un log d'erreur se passe tel quel sur l'entrée standard.Index, search, recall and save from the terminal or a script. An error log can be piped in as is.

API REST

Tout ce que fait le Studio passe par /api/v1 : recherche, mémoire, statistiques, export en JSON Lines.Everything the Studio does goes through /api/v1: search, memory, stats, JSON Lines export.

Pas que pour le codeNot only for code

Un assistant vocal ou un agent de support ont le même besoin : ne pas redemander ce qu'on leur a déjà dit.A voice assistant or a support agent need the same thing: not to ask again what they were already told.

04 · intégrationsintegrations

Branche n'importe quel client MCP.Plug in any MCP client.

Lorag sert MCP en HTTP sur localhost:8080/mcp. Le Studio donne la configuration de chaque client et la teste.Lorag serves MCP over HTTP on localhost:8080/mcp. The Studio gives each client's configuration and tests it.

Le plugin ajoute le serveur, un hook qui rappelle un correctif quand une commande échoue, et le skill /lorag:memory.The plugin adds the server, a hook that recalls a fix when a command fails, and the /lorag:memory skill.

/plugin marketplace add raucheacho/lorag-claude-code
/plugin install lorag@lorag

~/.cursor/mcp.json

{
  "mcpServers": {
    "lorag": { "url": "http://localhost:8080/mcp" }
  }
}

.vscode/mcp.json

{
  "servers": {
    "lorag": { "type": "http", "url": "http://localhost:8080/mcp" }
  }
}

Tout client qui accepte un serveur HTTP (Streamable HTTP)Any client that accepts an HTTP (Streamable HTTP) server

{
  "mcpServers": {
    "lorag": { "type": "http", "url": "http://localhost:8080/mcp" }
  }
}

OutilTool	RôleRole
memory_recallread	Un correctif, une réponse ou un fait déjà connuA fix, an answer or a fact already known
memory_savewrite	Garde ce qui est vérifié et réutilisableKeeps what is verified and reusable
memory_feedbackwrite	Dit si une entrée a aidéSays whether an entry helped
searchread	Cherche dans tes fichiers, avec la positionSearches your files, with the position
get_documentread	Le texte complet d'un documentThe full text of a document
ingestwrite	Indexe un fichier ou un dossierIndexes a file or a folder
get_statsread	Documents, morceaux, mémoire et état de l'indexDocuments, chunks, memory and index state

05 · installerinstall

Trois commandes.Three commands. Il tourne en fond avec ta session.It runs in the background with your session.

1
Installe LoragInstall Lorag

Le Studio, le moteur et les outils PDF, audio, vidéo et OCR viennent avec.The Studio, the engine and the PDF, audio, video and OCR tools come with it.

brew install raucheacho/tap/lorag

brew services start lorag
2
Ajoute le modèleAdd the model

Un modèle d'embedding multilingue pour Ollama, 1,2 Go.A multilingual embedding model for Ollama, 1.2 GB.

ollama pull bge-m3
3
Indexe et brancheIndex and connect

Le Studio s'ouvre sur localhost:8080 : choisis un dossier, puis copie la configuration de ton client dans Connect.The Studio opens on localhost:8080: pick a folder, then copy your client's config from Connect.

lorag open

macOS: 13 Ventura ou plus13 Ventura or laterPuce Apple ou Intel.Apple chip or Intel.
Linux: amd64, arm64glibc 2.28 ou plus (Debian 10, Ubuntu 20.04).glibc 2.28 or later (Debian 10, Ubuntu 20.04).
Embeddings: Ollama avec bge-m3 with bge-m3
InclusIncluded: poppler, ffmpeg, whisper.cpp, tesseractInstallés par Homebrew ; sur Linux, avec apt.Installed by Homebrew; on Linux, with apt.
LicenceLicense: MITMoteur Engine: VectixDB, Apache-2.0.

Donne une mémoire à tes agents.Give your agents a memory.
Libre et local.Open and local.