Common Errors and Solutions

# ✅ Always include required fields
llm_config = {
    "backend": "openai",
    "config": {
        "api_key": "your-api-key",
        "model_name_or_path": "gpt-4"
    }
}

# ✅ KVCache requires HuggingFace backend
kv_config = {
    "backend": "kv_cache",
    "config": {
        "extractor_llm": {
            "backend": "huggingface",
            "config": {
                "model_name_or_path": "Qwen/Qwen3-1.7B"
            }
        }
    }
}

# Start required services as needed
docker run -p 6333:6333 qdrant/qdrant
ollama serve

try:
    mem_cube.load("memory_dir")
except Exception:
    mem_cube = GeneralMemCube(config)
    mem_cube.dump("memory_dir")

import os
os.environ["CUDA_VISIBLE_DEVICES"] = "0"
# Use smaller models if GPU memory is limited: Qwen/Qwen3-0.6B

# Register user first
mos.register_mem_cube(cube_path="path", user_id="user_id", cube_id="cube_id")

# Check if user exists
try:
    user_id = mos.create_user(user_name="john", role=UserRole.USER)
except ValueError:
    user = mos.user_manager.get_user_by_name("john")