Strata

Tragbarer Agentenspeicher. Nur-Anhängen-Datensätze, verifizierte Herkunft, MCP-Werkzeuge und Selbsthosting.

Strata bietet einem Team einen dauerhaften Speicher, den jeder Agent lesen und aktualisieren kann, ohne Projekte zu vermischen, Geheimnisse preiszugeben oder die Geschichte umzuschreiben. Es ist für Arbeiten gebaut, die sich über Personen, Sitzungen, Maschinen und Laufzeiten bewegen.

Warum es existiert

Lokaler Agentenspeicher bricht, wenn Arbeit über Maschinen, Personen, Werkzeuge oder alte Sitzungen hinweg bewegt wird. Strata bewahrt die Fakten, die einen einzelnen Agentenlauf überdauern sollten:

• Versuchsergebnisse und Entscheidungen;

• Datensatznotizen, Quellprüfsummen und Extraktionsstatus;

• Verfahren, die funktioniert haben, und Fehler, die vermieden werden sollten;

• Projektübergaben für später hinzukommende Agenten.

Strata speichert keine Geheimnisse, rohe Transkripte, Gedankenketten, API-Schlüssel oder Anbietereinstellungen.

Related MCP server: memhippo

Was enthalten ist

Schnellstart

git clone https://github.com/rx6ru/strata.git
cd strata
python -m venv .venv
. .venv/bin/activate
python -m pip install -e .
strata --help

Starten Sie ein lokales Gateway:

strata serve --root /tmp/strata-demo --host 127.0.0.1 --port 8787

Überprüfen Sie es aus einer anderen Shell:

curl -fsS http://127.0.0.1:8787/healthz
curl -fsS -H 'X-Strata-Client: 1' http://127.0.0.1:8787/v1/status

Wenn Sie aus einem Quellcode-Checkout ausführen, bevor Sie das Paket installieren:

PYTHONPATH=. python -m strata --help
PYTHONPATH=. python -m strata root-hash --root /tmp/strata-demo

Lesen Sie die vollständige Einrichtungsanleitung in docs/getting-started.md.

Wie Agenten es verwenden

1. Kopieren Sie skills/strata/ in das Skill-Verzeichnis der Agentenlaufzeit.

2. Geben Sie dem Agenten nur nicht-geheime Laufzeitwerte, wie die Gateway-URL, den Namespace, die aktuelle Aufgabe, den SSH-Alias und den optionalen Pfad zum Lebenszyklus-Wrapper.

3. Der Agent ruft die Richtlinie ab, bereitet einen abgegrenzten Kontext vor, liest kanonische Datensätze und schreibt nur verifiziertes dauerhaftes Wissen.

4. Korrekturen hängen ersetzende Datensätze an. Reorganisation hängt Verschiebungs-, Teilungs-, Zusammenführungs- oder Ungültigkeitsereignisse an. Normale Agenten bearbeiten die Geschichte nie direkt.

Der Skill codiert keine Hostnamen, IP-Adressen, EC2-Instanz-IDs, Benutzernamen, API-Schlüssel, Projekt-Namespaces, Richtlinien-Hashes, Wurzeln oder Datensatz-IDs fest. Siehe docs/agent-skill.md.

Wie Schreibvorgänge sauber bleiben

Strata prüft jeden Schreibvorgang vor dem Commit:

• der aktuelle Richtlinien-Hash wird vor dem Commit bestätigt;

• Schemata validieren den Datensatz;

• Idempotenzschlüssel verhindern doppelte Wiederholungen;

• Nur-Anhängen-SQLite-Trigger blockieren direkte Bearbeitungen der Geschichte;

• Inhalts-Hashes und Root-Manifeste machen Exporte überprüfbar;

• Scanner für Geheimnisse und rohe Transkripte lehnen unsichere Nutzlasten ab;

• abgeleitete Erinnerung wird als Navigation gekennzeichnet, nicht als Wahrheit.

Selbsthosting

Für den Docker-Stack:

./scripts/configure.sh
./scripts/control.sh start

Für einen Systemdienst verwenden Sie die Installationsanleitung und den eingeschränkten Lebenszyklus-Wrapper in deploy/. Remote-Agenten sollten nur diesen Wrapper für status, start, stop oder restart aufrufen.

Die Standardbereitstellung hat keine Benutzer auf Anwendungsebene. Halten Sie sie auf Loopback, einem privaten Netzwerk, SSH, VPN, Firewall oder Ihrer eigenen Proxy-/Auth-Schicht. Lesen Sie docs/security-model.md und SECURITY.md, bevor Sie das Team hosten.

REST und MCP

Das REST-Gateway stellt unter /v1 Endpunkte für Gesundheit, Richtlinie, Status, Suche, Erinnerung, Datensatz, Anhängen, Ersetzen, Verschieben, Teilen, Zusammenführen und Ungültigmachen bereit.

Die MCP-Brücke stellt passende Werkzeuge wie memory_policy, memory_prepare_context, memory_search, memory_get, memory_capture_verified und memory_status bereit.

Bewertung

PYTHONPATH=. python -m strata eval --input tests/fixtures/strata_eval/cases.json

Die Testvorrichtung prüft Namespace-Isolation, Herkunft, Förder- und Ablehnungsverhalten, Kennzeichnungen abgeleiteter Erinnerungen und das Durchsickern verbotener Werte.

Lizenz

MIT. Siehe LICENSE. Hinweise zu Drittanbietern finden Sie in THIRD_PARTY_NOTICES.md.