Skip to main content
Every piece of information starts as an episode.

​
Adding Episodes

You can add episodes from various sources: 
from ryumem import Ryumem

ryumem = Ryumem(api_url="http://localhost:8000")

# Text episode
ryumem.add_episode(
    content="Alice graduated from Stanford in 2018.",
    user_id="user_123",
    session_id="session_abc",
    source="text",
)

# Message episode (conversational)
ryumem.add_episode(
    content="user: Where did you go to school?\nassistant: I went to MIT.",
    user_id="user_123",
    session_id="session_abc",
    source="message",
)

# JSON episode (structured data)
ryumem.add_episode(
    content='{"person": "Bob", "company": "Meta", "role": "Engineer"}',
    user_id="user_123",
    session_id="session_abc",
    source="json",
)

​
Episode Parameters

ParameterTypeRequiredDescription
contentstrYesThe content of the episode
user_idstrYesUser identifier for multi-tenancy
session_idstrYesSession identifier for grouping related episodes
sourcestrNoEpisode type: text, message, or json (default: text)
kindstrNoEpisode kind: query or memory (default: query)
metadatadictNoAdditional metadata to attach to the episode
agent_idstrNoOptional agent identifier

​
Episode Kinds

  • query: Represents user queries or interactions (default)
  • memory: Represents stored memories or facts extracted from conversations