GUMem

GUMem (General User Memory) turns conversation messages and user behavior into retrievable, governable Memory. After reading these docs, you can integrate GUMem from a server-side application and let an Agent use historical preferences, constraints, and behavior signals in later tasks.

GUMem is not just chat history storage. It turns raw Message input into traceable Facts, compresses those Facts into long-term Summary, and uses Topic to retrieve related memory. It is best for information that should change future task decisions, such as stable preferences, explicit plans, long-lived constraints, auditable actions, and context reused across Sessions.

When to use GUMem

• Your Agent needs to remember user preferences across turns or Sessions.
• User behavior says more than the user explicitly typed, such as searches, filters, saves, skips, or tool results.
• You need Message, Facts, Summary, and recall results for audit or governance.
• You do not want to put all historical messages into the prompt, and instead want task-relevant context.

When not to use GUMem

• The information is only useful inside the current request.
• The data contains sensitive information that should not be stored long term without a governance policy.
• A short recent-message window is enough for the product behavior.
• You have not defined user identity, Session lifetime, and Memory write boundaries.

Documentation entry points

• Overview explains GUMem's role, boundaries, and core capabilities.
• Quick Start creates a Session, writes Memory, and recalls it with the Node SDK, Python SDK, or cURL.
• How GUMem Works explains the Topic -> Summary -> Facts -> Message user model.
• Multimodal Content explains how text, image, and video content enters GUMem.
• Performance covers benchmark and read/write performance reporting.
• Add Memory writes new Message input.
• Query Memory explains how to recall relevant Topic, Summary, Facts, and recent Message context.
• Integration covers the full Node SDK and Python SDK guides.
• User Case shows how GUMem fits into a real Agent turn.