Skip to content

README_DE.md

Latest commit

 

History

History
226 lines (159 loc) · 7.43 KB

README_DE.md

File metadata and controls

226 lines (159 loc) · 7.43 KB

MemoryOS-Rust

⚠️ Diese Übersetzung kann hinter der englischen README zurückliegen. Im Zweifelsfall gilt die englische Version.

Hochleistungs-KI-Agent-Speicherverwaltungssystem - Rust-Implementierung

License Rust Status Tests

Sprachen: English | 简体中文 | 日本語 | Français | العربية | Deutsch | Español | 한국어

🎯 Überblick

MemoryOS-Rust ist ein Hochleistungs-KI-Agent-Speicherverwaltungssystem, das mit Rust + Tokio entwickelt wurde. Es verfügt über eine 3-stufige Speicherarchitektur (STM/MTM/LTM), OpenAI-API-Kompatibilität und unterstützt über 100.000 gleichzeitige Benutzer.

✨ Hauptmerkmale

  • 🚀 Hohe Leistung: Rust + Tokio, unterstützt hohe Parallelität mit über 10K QPS pro Instanz.
  • 🧠 3-stufiger Speicher: STM (Redis) → MTM (Qdrant) → LTM (Qdrant).
  • 🔌 Universelles Gateway: OpenAI-Protokoll-kompatibel, unterstützt Gemini, Claude, Ollama, DeepSeek, Azure.
  • 🕸️ Graph-Speicher: Qdrant-Native GraphRAG mit Mermaid-Visualisierung.
  • 📚 Wissensexport: Automatischer Export von FAQs ins Wiki (S3/Confluence), unterstützt Agent Playbook.
  • 🛡️ Unternehmenssicherheit: RBAC, PII-Bereinigung, Prompt-Injection-Abwehr, DSGVO-Recht auf Vergessenwerden.
  • 🤖 Intelligentes Routing: Automatisches Routing zwischen lokalem Llama (heiß/privat) und Cloud-GPT-4 (komplex/kalt).

💻 Systemanforderungen

Spez. Minimum (Dev) Empfohlen (Prod)
CPU 2 vCPU 4+ vCPU
RAM 4GB 16GB+
Festplatte 10GB SSD 100GB NVMe
OS Linux / macOS Linux (K8s)

🚀 Schnellstart

1. Abhängigkeiten starten

docker-compose up -d

2. Konfiguration

.env-Datei erstellen (optional) oder Umgebungsvariablen setzen:

export GEMINI_API_KEY="your_key_here"
export QDRANT_API_KEY="your_qdrant_key"

Konfigurationsdatei kopieren:

cp config.example.toml config.toml
# config.toml bearbeiten, um gewünschte Module zu aktivieren (Router, Wiki, etc.)

3. Ausführen

# Standard-Vollmodus
cargo run --release --bin memoryos-gateway

# (Erweitert) Nur bestimmte Features aktivieren (falls Cargo.toml unterstützt)
# cargo run --release --no-default-features --features "redis,qdrant"

4. Test

curl http://localhost:8080/health/status

Detaillierte Anleitung: docs/QUICKSTART.md

🏗️ Architektur

graph TD
    Client[User Client] -->|OpenAI Protocol| Gateway
    subgraph MemoryOS-Rust
        Gateway -->|Auth & Shield| Router{Smart Router}
        Router -->|Tier 0: FAQ| DirectHit[Direct Response]
        Router -->|Tier 1: Hot| LocalLLM[Local Llama]
        Router -->|Tier 2: Cold| CloudLLM[OpenAI/Gemini]
        Gateway -->|Async Event| Queue[NATS/Redis]
        Queue --> Worker
        Worker -->|Summarize| VectorDB[(Qdrant)]
        Worker -->|Export| Wiki[S3/Confluence]
    end
Loading

Detaillierte Architektur: docs/ARCHITECTURE.md

📚 Dokumentation

Benutzerdokumentation

Vertiefung

Entwicklerdokumentation

⭐ Empfohlen: Designprinzipien und Vergleich für Systemdesign-Einblicke

📊 Projektstatus

Version: 0.2.0
Status: ✅ Produktionsbereit
Fertigstellung: 100%

Phase Modul Status
Phase 1 Foundation (Config/Log) ✅
Phase 2 Gateway & Adapters ✅
Phase 3 Storage (Redis/Qdrant) ✅
Phase 4 Intelligence (Router/Shield) ✅
Phase 5 Worker & Async ✅
Phase 6 Wiki Export ✅
Phase 7 Graph Memory ✅

🛠️ Tech-Stack

  • Sprache: Rust 1.93+
  • Async-Runtime: Tokio
  • Web-Framework: Axum
  • Kurzzeitspeicher: Redis
  • Vektorspeicher: Qdrant
  • LLM: OpenAI, Gemini, Claude, Ollama, DeepSeek, OpenRouter, Azure

🤝 Mitwirken

Beiträge sind willkommen! Bitte folgen Sie diesem Workflow:

Vor dem Start

  1. 📖 Entwicklungshandbuch lesen
  2. 📝 Aufgabe in WORK_LOG.md protokollieren
  3. 🔄 Neuesten Code pullen: git pull

Während der Arbeit

  1. 📊 Fortschritt täglich in WORK_LOG.md aktualisieren
  2. 🐛 Probleme sofort protokollieren
  3. 🔴 Status aktualisieren, wenn blockiert

Nach Fertigstellung

  1. ✅ Aufgabe als abgeschlossen in WORK_LOG.md markieren
  2. 📝 CHANGELOG.md aktualisieren
  3. 🚀 Code einreichen: git commit && git push

Zusammenarbeit: Wir verwenden eine Dual-Track-Aufzeichnung WORK_LOG.md (menschlich) + docs/state.json (KI) für transparente Zusammenarbeit.

Detaillierte Anleitung: CONTRIBUTING.md

🔧 Wartungsstatus

Aktueller Status: ✅ Produktionsbereit & Aktiv Gewartet

Dieses Projekt ist vollständig (100%) und im Wartungsmodus. Wir konzentrieren uns auf:

  • 🐛 Fehlerbehebungen und Sicherheitsupdates
  • 📚 Dokumentationsverbesserungen
  • 💡 Community-getriebene Verbesserungen

Siehe: MAINTENANCE.md für detaillierten Wartungsplan

📞 Kontakt

📄 Lizenz

Apache 2.0 Lizenz - Siehe LICENSE

🌟 Verwandte Projekte

Version: 0.2.0 | Aktualisiert: 2026-02-18