MIRA 0.8.6 · MÉMOIRE LOCALE POUR AGENTS

La mémoire qui
fait le tri.

MIRA est une couche de mémoire locale et agnostique au modèle. Elle retrouve, compose et restitue le contexte dont votre agent a besoin dans le budget que vous fixez.

curl -fsSL https://mira.devbyben.fr/install | bashVoir l'installation

Code source public · usage non commercial · aucun compte requis

010.8.6version du core documentée

02Local-firstSQLite ou PostgreSQL

03Rappelrecherche dense et lexicale

04Mesuresprotocole reproductible

01 / LE PROBLÈME

Un agent qui oublie
coûte deux fois.

Une trace de mémoire qui se dédouble en deux chemins de recherche
oubli → deux chemins neuronaux
01

Une première fois lorsqu'il relit un historique trop long. La fenêtre se sature avant l'action.

02

Une seconde quand il agit sans la décision, la préférence ou la cause qui change tout.

MIRA est une couche de mémoire locale. Chaque rappel est composé pour garder l'information utile dans la fenêtre de contexte, avec sa provenance et ses relations.

Un stockage mémoire local relié à ses niveaux de données et chemins de rappel
RAG CLASSIQUEOUT OF DATE

« Qu'est-ce qui ressemble ? »

Des documents proches de la requête, sans sélection contextualisée.

MIRA

« Qu'est-ce qui aide ? »

Un contexte composé, pondéré et calibré pour agir.

Respecte une limite de contexte
RAG ·selon l’outil
MIRA ·budget explicite
Adapte le niveau de détail
RAG ·—
MIRA ·T0 / T1 / T2
Relie causes et conséquences
RAG ·—
MIRA ·graphe causal
Peut fonctionner sans service cloud
RAG ·variable
MIRA ·configuration locale

02 / TROIS PROFONDEURS

UNE MÉMOIRE, TROIS NIVEAUX DE FIDÉLITÉ

Trois niveaux.
Un rappel ajusté.

Trois niveaux de mémoire représentés par des strates de densité décroissante
strates / fidélité variable

NIVEAU 2 / 03

Le sens

EMPREINTE CONTEXTE≈ 30 tok. estimés

Les faits, décisions et relations sont extraits sous forme structurée.

densité de rappelcompacte
DÉCISION
PostgreSQL
RAISON
ACID, expertise équipe
ALTERNATIVES
MySQL, SQLite, écartées
STATUT
Validée en réunion 12/03

EMPREINTE ESTIMÉE · T0/T1 utilisent l’estimateur local de MIRA ; le budget du rappel compte les groupes séparés par des espaces dans le corps rendu, pas les tokens du modèle. · COHÉRENCE AUTONOME · provenance → lifecycle → belief → CBA · Les sources consolidées restent révocables et chaque croyance garde sa confiance, ses preuves et sa validité temporelle.

03 / CBA ALLOCATOR

LE CBA TRIE LES CANDIDATS.

Un budget. Huit signaux.
Une décision.

Le CBA combine huit signaux pour classer les souvenirs, puis recalcule leur valeur après chaque sélection afin de remplir le budget de contexte sans dépasser les unités comptées.

Huit chemins convergeant vers un nœud de décision
huit signaux → une décision
01

RECHERCHER

HNSW top-100 ∥ plein texte SQL

La recherche dense et le plein texte du backend réunissent les candidats.

ANN
02

ÉVALUER

RRF k=60 · clustering ≥ 0.88

Les classements fusionnés sont filtrés par un seuil de pertinence.

ρ ≥ θ
03

ALLOUER

argmax S(m | S)

Les mémoires les plus utiles sont retenues dans un budget limité.

budget B
SCORE MARGINAL / HEURISTIQUE CBA
S(m | S) = ρ × δ × η × q × β × (1−σ(S)) × τ(S) × χ(S) × υ(S), si ρ ≥ θ
ρSeuil
Doit atteindre θ pour que le souvenir entre dans le calcul.
qQualité
Confiance d’extraction, fraîcheur de validation et cycle de vie.
βCroyance
Calibration locale bornée entre 0,75 et 1,2.
χCausalité
Liens causaux confirmés entre les souvenirs.
υCouverture
Pondère les sujets encore peu représentés.
RECALCUL / À CHAQUE SÉLECTION

MIRA réévalue les souvenirs restants à partir de ceux déjà retenus.

COMPTAGE DU BUDGET

Les unités sont les groupes séparés par des espaces dans le corps rendu. Le calcul exclut l’enveloppe ajoutée par l’agent et ne suit pas le tokenizer d’un modèle.

REQUÊTE COURTE

Moins de cinq mots : la limite effective baisse de 20 %.

PORTÉE DE L’HEURISTIQUE

Le classement n’assure pas d’optimum global.

Pertinence

Le sujet est-il vraiment le bon ?

cos(embedding, requête)
Temporalité

Est-ce encore actuel ?

exp(−λ × âge)
Qualité

L'extraction et la validation tiennent-elles ?

confidence × fraîcheur × lifecycle
Croyance

La source a-t-elle fait ses preuves ?

calibration bornée 0.75…1.2
Session

Est-il dans la session active ?

boost de session · fenêtre configurée
Densité

Quelle valeur dans le corps rendu ?

sigmoïde(faits / √unités)
Redondance

Est-ce déjà présent ?

max cosine avec S sélectionné
Causalité

Quel lien avec l'histoire ?

because · resolves · updates

04 / CE QUE ÇA CHANGE

UNE MÉMOIRE QUI CRÉE UN AVANTAGE PRODUIT

Moins de répétition.
Plus de continuité.

01

AGENTS DE DÉVELOPPEMENT

La décision revient avec sa raison.

L'agent retrouve le choix d'architecture, les alternatives rejetées, la validation et le contexte de la décision, même plusieurs sprints plus tard.

SORTIE · décision + cause + alternatives rejetées
02

ASSISTANTS PERSONNELS

Les préférences survivent aux sessions.

Les habitudes importantes restent d'une session à l'autre. Les notes éphémères déclinent avec le temps. L'assistant évolue sans repartir de zéro.

PRÉFÉRENCES · demi-vie 69 j · stable vs éphémère
03

ÉQUIPES & PRODUITS IA

Une mémoire commune sur vos données.

Wings et rooms isolent chaque domaine métier. MCP, REST et CLI branchent la même mémoire locale partout où vos agents travaillent.

PORTÉE · wings isolés · MCP · REST · CLI

05 / MOTEUR DE RAPPEL

RECONSTRUIRE LE FIL DU RAPPEL

Le rappel utile demande
plus qu'une recherche.

PIPELINE / CONTEXT RECALL

Du rappel au contexte utile

CAPTURE → RENDU
Le contexte capturé alimente deux recherches, HNSW et plein texte, qui convergent avec RRF avant l’allocation CBA et le rendu.
  1. 01CaptureT0 / T1 / T2 · projections
  2. 02Recherche hybrideembedding · HNSW ∥ SQL
  3. 03FusionRRF · classement consolidé
  4. 04AllocationCBA · budget et signaux
  5. 05Rendumémoire utile à l’agent

La requête est embarquée, puis HNSW et le plein texte du backend élargissent les candidats. RRF fusionne les classements ; CBA alloue le budget selon la provenance, le cycle de vie, la causalité et la calibration locale.

SQLite FTS5PostgreSQL plein texte natifWindows repli SQL portable
  1. 01
    STATION 01Requête

    embed · 3 variantes · cache

  2. 02
    STATION 02Hybride

    HNSW dense ∥ recherche plein texte SQL

  3. 03
    STATION 03Fusion

    RRF k=60 · IQR · cluster

  4. 04
    STATION 04Allocation

    CBA glouton · q β σ χ τ υ

  5. 05
    STATION 05Rendu

    Header · Fingerprint · Verbatim

CAUSALES

Les causes restent liées
aux décisions.

Le graphe causal relie causes, contradictions et résolutions avec preuve et confiance. La pénalité χ évite d'isoler une conséquence de sa cause.

LANGUES

La recherche peut rapprocher
des formulations différentes.

L'expansion de requête et les embeddings peuvent aider avec les paraphrases. Les résultats entre langues dépendent du modèle d'embedding configuré et ne sont pas garantis.

TEMPS

La temporalité dépend
du type de mémoire.

Chaque type a son λ : une décision tient (0.001), un log de debug s'efface (0.5). Le paramètre réduit le bruit sans raccourcir la durée des décisions.

REPLI

Le repli SQL garde
le rappel disponible.

Quand HNSW n'est pas prêt, MIRA bascule sur SQL portable, avec SQLite ou PostgreSQL. Une wing vide utilise le chemin de repli prévu pour elle.

06 / IDENTITÉ INTÉGRÉE

MÉMOIRE ET IDENTITÉ RESTENT DISTINCTES

Ce que l'agent sait
et ce qui le définit.

Personnalité, voix, valeurs et tonalité traversent les sessions et les changements de modèle. Les captures structurées apprennent uniquement des messages assistant ; les preuves de travail restent non normatives et reçoivent leur budget après les invariants d'identité.

Voir les outils d'identité
La voix, les valeurs et le style forment un noyau identitaire stable transmis à plusieurs modèles, distinct des faits mémoire
MÉMOIRE
faits · contextes · causes
IDENTITÉ
soul · voix · valeurs · style

07 / PASSEZ À L'ACTION

BRANCHEZ-LA À VOTRE STACK

Une commande.
Votre mémoire.

MIRA se connecte aux agents, aux applications et aux opérations. Installez-la dans l'environnement où vos données doivent rester.

INSTALLATION LOCALE / 01

Un binaire et un stockage local suffisent pour commencer. Aucun compte n'est requis.

TERMINAL / BASH
curl -fsSL https://mira.devbyben.fr/install | bash
Lire la documentation
INTERFACES / 02 PRÊT À RECEVOIR
{
  "tool": "mira_recall",
  "arguments": { "query": "Pourquoi PostgreSQL ?", "budget": 2000 }
}

INSTALLATION AGENT / 03

Le branchement
que l'agent comprend.

Installez MIRA dans votre agent avec la commande ci-dessous, ou sélectionnez un client pour afficher sa commande dédiée. Le diagnostic indique si le rappel et la capture sont automatiques ou guidés par le skill.

SKILL / MÉMOIRE LOCALE

Le skill indique à l’agent quand consulter MIRA et comment conserver les décisions durables, sans stocker de secrets.

  1. CODEX / CONNEXIONmira agent install --client codex --scope project --policy standard --wing auto
  • Codex
  • Claude Code
  • Windsurf
  • Cursor
  • Claude Desktop
  • Hermes
  • OpenCode
  • Pi Agent

CLAUDE DESKTOP / LINUX--client-config

01Serveur MCP
stdio, SSE ou HTTP
02API REST optionnelle
OpenAPI 3.1
03Observabilité native
Prometheus & healthchecks
LOCALBinaire Go, code source public
sans compte ni API d'inférence distante requise

08 / AVANT DE COMMENCER

Les questions
fréquentes.

Installation, stockage et continuité d'identité : les réponses essentielles avant de brancher MIRA.

MIRA remplace-t-il mon LLM ou mon framework agent ?+

MIRA complète le LLM et le framework agent. C'est une couche de mémoire agnostique au modèle, accessible via MCP, REST ou CLI.

Mes données quittent-elles ma machine ?+

Le stockage SQLite ou PostgreSQL, l’index HNSW et les embeddings peuvent fonctionner localement. Les transports réseau et services externes suivent les endpoints activés dans votre configuration.

Pourquoi ne pas utiliser seulement une base vectorielle ?+

MIRA combine la recherche vectorielle avec un budget de tokens, la densité d'information, le temps, la qualité, la fiabilité des croyances, la redondance, la session et la causalité. Ces signaux servent à sélectionner ce qui aide réellement.

Comment la continuité d'identité est-elle gérée ?+

La continuité d'identité est activée dans MIRA par les outils MCP soul_capture, soul_recall, soul_drift, soul_swap, soul_status, soul_history, soul_update et soul_patch. Ils partagent la mémoire et le stockage de MIRA.

Comment installer MIRA ?+

Sous Linux et macOS, lancez curl -fsSL https://mira.devbyben.fr/install | bash. Sous Windows, utilisez install.ps1 dans PowerShell. Les scripts téléchargent la version publiée et vérifient son checksum.

Sur quels systèmes MIRA fonctionne-t-il ?+

Les scripts couvrent Linux et macOS en amd64 ou arm64, ainsi que Windows en x64 ou arm64. MIRA reste agnostique au modèle et se branche à l'agent par MCP, REST ou CLI.

MÉMOIRE LOCALE, CONTEXTE UTILE

Vos agents peuvent
réutiliser
ce qu'ils savent déjà.

Code source public, installation locale, intégration directe.

Des faits mémorisés convergent vers un contexte ordonné pour l’agent
MIRA / MÉMOIRE LOCALE