MemoraEU SDK — Python

Couche mémoire persistante zero-knowledge pour LLMs.
Compatible avec n'importe quel projet Python — sync ou async.

Installation

pip install memoraeu

Démarrage rapide

1. Obtenir vos clés

1. Créez un compte sur app.memoraeu.com
2. Paramètres → Clés de chiffrement → copiez MEMORAEU_SALT
3. Paramètres → Clés API → créez une clé → copiez MEMORAEU_API_KEY (meu-sk-…)
4. secret = votre mot de passe de connexion MemoraEU

2. Client sync

from memoraeu import MemoraEU

client = MemoraEU(
    api_url="https://api.memoraeu.com",
    api_key="meu-sk-...",        # clé API (authentification HTTP)
    secret="votre-mot-de-passe", # mot de passe MemoraEU (dérivation de clé locale)
    salt="votre-kdf-salt",       # salt unique à votre compte (depuis les Paramètres)
)

# Mémoriser
memory = client.remember(
    "Philippe préfère Python et FastAPI",
    category="prefs",
    tags=["python", "stack"]
)

# Rechercher
results = client.recall("préférences tech", limit=3)
for r in results:
    print(f"[{round(r.score*100)}%] {r.memory.content}")

# Supprimer
client.forget(memory.id)

3. Client async

from memoraeu import AsyncMemoraEU

async with AsyncMemoraEU(
    api_url="https://api.memoraeu.com",
    api_key="meu-sk-...",
    secret="votre-mot-de-passe",
    salt="votre-kdf-salt",
) as client:
    memory = await client.remember("...")
    results = await client.recall("...")

Comprendre les paramètres

Zero-knowledge : la clé de chiffrement est dérivée sur votre machine avec PBKDF2(secret, salt, 210 000 itérations). Le serveur reçoit uniquement le contenu chiffré — il ne peut pas le lire même s'il est compromis.

⚠️ Si vous perdez votre secret ou votre salt, vos mémoires chiffrées sont irrécupérables.

Référence

Gestion des erreurs

from memoraeu import APIError, CryptoError, ConnectionError

try:
    client.remember("...")
except APIError as e:
    print(e.status_code, str(e))  # ex: 401, 409
except CryptoError as e:
    print("Problème de chiffrement", e)
except ConnectionError as e:
    print("API inaccessible", e)

Auto-hébergement

client = MemoraEU(
    api_url="http://localhost:8000",
    api_key="meu-sk-...",
    secret="...",
    salt="...",
)

Licence

MIT © MemoraEU