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."},
    ],
    async_mode=False,  # wait until the messages are stored
)

# The conversation is over, so extract it now.
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")

memory_id = data.episodes[0].id

# Rewrite part of the episode. Fields you leave out keep their value.
client.update(memory_id, subject="Coffee order", reason="wrong_subject")

# Record whether the memory was right. This stores the rating and changes nothing.
client.feedback(memory_id, "positive")

# Delete up to 50 memories by id.
client.delete_by_ids([memory_id], reason="redundant")