sinapsis-mem0 0.2.1

Sinapsis templates for Mem0 memory management.

Sinapsis Mem0

Sinapsis templates for managed and self-hosted Mem0 memory workflows.

🐍 Installation • 🚀 Features • 📚 Usage example • 📙 Documentation • 🔍 License

The sinapsis-mem0 package adds persistent memory workflows to Sinapsis agents through both the managed Mem0 platform and the open-source self-hosted backend.

🐍 Installation

Install using your preferred package manager. We strongly recommend using uv.

uv pip install sinapsis-mem0 --extra-index-url https://pypi.sinapsis.tech

Or with raw pip:

pip install sinapsis-mem0 --extra-index-url https://pypi.sinapsis.tech

[!IMPORTANT] Managed Mem0 templates require an API key:

export MEM0_API_KEY="your-api-key"

🚀 Features

Templates Supported

• Managed Mem0 templates: Mem0ManagedAdd, Mem0ManagedGetAll, Mem0ManagedGetMemory, Mem0ManagedSearch, Mem0ManagedDeleteAll, Mem0ManagedDeleteMemory, Mem0ManagedReset
• OSS Mem0 templates: Mem0OSSAdd, Mem0OSSGetAll, Mem0OSSGetMemory, Mem0OSSSearch, Mem0OSSDeleteAll, Mem0OSSDeleteMemory, Mem0OSSReset

🌍 Managed Templates

• Managed templates use the Mem0 platform through MemoryClient.
• memory_config can include values such as host, org_id, and project_id.
• Operation-specific arguments are passed through add_args, get_args, search_args, or delete_args depending on the selected template.
• Mem0ManagedDeleteAll uses only the configured delete_args scope; it does not derive scope from packet identity.

🧱 OSS Templates

• OSS templates use the self-hosted Mem0 backend through Memory.
• memory_config is used to configure the local backend.
• The same operation families are available: add, get, search, delete, and reset.
• Mem0OSSDeleteAll uses only the configured delete_args scope; it does not derive scope from packet identity.

[!TIP] Use CLI command sinapsis info --all-template-names to show a list with all the available Template names installed with Sinapsis Mem0.

📚 Usage example

The following agent retrieves all memories for the given user_id and run_id from the managed Mem0 platform.

Config

agent:
  name: mem0_managed_get_all_memories
  description: Retrieves all scoped memories from managed Mem0.

templates:
  - template_name: InputTemplate
    class_name: InputTemplate
    attributes: {}

  - template_name: Mem0ManagedGetAll
    class_name: Mem0ManagedGetAll
    template_input: InputTemplate
    attributes:
      get_args:
        user_id: Sarah
        run_id: conv_1234

📙 Documentation

Documentation for this and other sinapsis packages is available on the sinapsis website

Tutorials for different projects within sinapsis are available at sinapsis tutorials page

🔍 License

This project is licensed under the AGPLv3 license, which encourages open collaboration and sharing. For more details, please refer to the LICENSE file.

For commercial use, please refer to our official Sinapsis website for information on obtaining a commercial license.