Was macht flux7-memory?
Gemanagte Multi-Agenten-Gedächtnis für KI-Agenten — hybride Markdown+SQLite, FTS, Vektorsuche, LLM-Neubewertung. Ein Go-Binary, MCP stdio + HTTP + SSE.
Eigenschaften
- Hybrider Speicher: Markdown-Dateien + SQLite mit FTS5-Volltextsuche.
- Semantische Suche: Lokale Vektoreinbettung und -suche über das Parquet-Format.
- LLM-Reranking: Verbessert Suchergebnisse durch ein lokales LLM (z. B. Ollama, llama.cpp).
- Multi-Agenten-Freigabe: Verschiedene KI-Agenten können denselben Speicher nutzen.
- Datenschutz: Keine externen APIs erforderlich, alle Berechnungen laufen lokal.
- Go-Binärdatei: Einfach bereitzustellen, keine Runtime-Abhängigkeiten.
- MCP-Schnittstellen: Unterstützt stdio (nativ), HTTP und SSE.
Verwendung
Als MCP-Tool (Empfohlen)
# Starten mit stdio (Default für Claude Code)
./flux7-memory
# Mit HTTP-API
./flux7-memory --http :8080
# Mit SSE (streaming)
./flux7-memory --sse
Konfiguration
Erstellen Sie eine config.yaml oder setzen Sie Umgebungsvariablen:
| Variable | Beschreibung | Standard |
|---|---|---|
MEMORY_PATH | Pfad zum Speicherverzeichnis | ./memory |
MODEL_PATH | Pfad zum Embedding-Modell | automatisch heruntergeladen |
LLM_URL | URL für Reranking-LLM | http://localhost:11434 |
EMBED_DIM | Dimension der Embeddings | 384 |
FTS_ENABLE | Volltextsuche aktivieren | true |
VECTOR_ENABLE | Vektorsuche aktivieren | true |
Schnellstart
- Herunterladen:
go install github.com/KTCrisis/flux7-memory@latest - Ausführen:
./flux7-memory --initinitialisiert den Speicher - Agenten verbinden: Konfigurieren Sie Ihren Agenten, um den MCP-Server zu verwenden
Plattformen
- Claude Code: Native stdio-Unterstützung, verwaltet über
~/.claude/agents.json - Cursor: Kompatibel über MCP-Protokoll
- Codex: Unterstützt über SSE oder HTTP
- Jeder MCP-kompatible Agent: Funktioniert mit allen MCP-Clients
Wie es funktioniert
- Eingabe akzeptieren (Nachricht, Datei, Abfrage)
- Markdown parsen und Metadaten extrahieren
- Sowohl Volltext- als auch Vektorsuchen durchführen
- Ergebnisse mit LLM neu bewerten für kontextuelle Relevanz
- Antwort an Agenten zurückgeben
Der Speicher lernt mit der Zeit, indem er Interaktionen speichert und die zugrunde liegenden Daten aktualisiert.
Lizenz
MIT - Siehe LICENSE für Details.