pip install hystersis

from hystersis import Hystersis

client = Hystersis(
    base_url="https://api.hystersis.com",
    api_key="your-key"
)

memory = client.create_memory(
    content="User prefers dark mode",
    user_id="user-123",
    category="preferences",
    metadata={"source": "settings"}
)

results = client.search(
    query="display settings",
    limit=10,
    threshold=0.7
)

memory = client.get_memory(memory_id)

client.update_memory(
    memory_id="...",
    content="Updated content"
)

client.delete_memory(memory_id)

session = client.create_session(
    agent_id="assistant-bot"
)

client.add_message(
    session_id=session["id"],
    role="user",
    content="Hello!"
)

entity = client.create_entity(
    name="Machine Learning",
    entity_type="topic",
    properties={"category": "AI"}
)

client.add_feedback(
    memory_id="...",
    feedback_type="positive"
)

from hystersis import Hystersis, AuthenticationError, NotFoundError

try:
    memory = client.get_memory("invalid-id")
except NotFoundError:
    print("Memory not found")
except AuthenticationError:
    print("Invalid API key")