Cloud Quickstart

pip install everos-cloud

from everos_cloud import EverOS

client = EverOS(api_key="your_api_key")

client.add(
    session_id="session_gs_001",
    messages=[
        {"sender_id": "user_demo_001", "role": "user",
         "content": "I like black Americano, no sugar, the stronger the better!"},
        {"sender_id": "user_demo_001", "role": "user",
         "content": "Today I want to discuss the project progress."},
    ],
)

# Extraction is async; flush forces it for a session right away
client.flush("session_gs_001")

data = client.get("episode", user_id="user_demo_001")
print(f"Fetched {data.count} memories")

results = client.search(
    "coffee preference",
    user_id="user_demo_001",
    method="vector",
    top_k=5,
)
episodes = results.episodes or []
print(f"Found {len(episodes)} memories")