Cloud Quickstart

pip install everos

from everos import EverOS

client = EverOS(api_key="your_api_key")
memories = client.v1.memories

import time

now_ms = int(time.time() * 1000)

response = memories.add(
    user_id="user_demo_001",
    session_id="session_gs_001",
    messages=[
        {
            "role": "user",
            "timestamp": now_ms,
            "content": "I like black Americano, no sugar, the stronger the better!",
        },
        {
            "role": "user",
            "timestamp": now_ms + 86_400_000,  # 1 day later
            "content": "Today I want to discuss the project progress.",
        },
    ],
)
print(f"status={response.data.status}  task_id={response.data.task_id}")

# Flush to trigger immediate memory extraction
memories.flush(user_id="user_demo_001", session_id="session_gs_001")

response = memories.get(
    filters={"user_id": "user_demo_001"},
    memory_type="episodic_memory",
)

episodes = response.data.episodes if response.data else []
print(f"Fetched {len(episodes) if episodes else 0} memories")

response = memories.search(
    filters={"user_id": "user_demo_001"},
    query="coffee preference",
    method="vector",
    top_k=5,
)

episodes = response.data.episodes if response.data else []
print(f"Found {len(episodes)} memories")