pip install flumes-ai
# optional Agent helper – requires OpenAI client
pip install "flumes-ai[agent]"

from flumes import MemoryClient

client = MemoryClient(api_key="FLUMES_KEY", agent_id="demo-bot", namespace="prod")
u = client.for_entity("user_001")

res = u.add(
    "I'm Alice, living in Paris; I prefer museums over nightlife and love quiet wine bars.",
    budget="standard",
)
print(res.get("pack"))

hits = u.search("quiet dinner near a scenic run in Lyon", top_k=8, include_scores=True)
print(len(hits.get("matches", [])))

from flumes import Agent
agent = Agent(
  agent_id="demo-bot",
  entity_id="user_001",
  memory_client=client,
  openai_api_key="OPENAI_KEY",
)
print(agent.chat("Plan my trip."))