Async Client - Mem0

AsyncMemoryClient

The AsyncMemoryClient is an asynchronous client for interacting with the Mem0 API. It provides similar functionality to the synchronous MemoryClient but allows for non-blocking operations, which can be beneficial in applications that require high concurrency.

Initialization

To use the async client, you first need to initialize it:

Python

import os
from mem0 import AsyncMemoryClient

os.environ["MEM0_API_KEY"] = "your-api-key"

client = AsyncMemoryClient()

JavaScript

const { MemoryClient } = require('mem0ai');
const client = new MemoryClient({ apiKey: 'your-api-key'});

Methods

The AsyncMemoryClient provides the following methods:

Add

Add a new memory asynchronously.

Python

messages = [\
    {"role": "user", "content": "Alice loves playing badminton"},\
    {"role": "assistant", "content": "That's great! Alice is a fitness freak"},\
]
await client.add(messages, user_id="alice")

JavaScript

const messages = [\
    {"role": "user", "content": "Alice loves playing badminton"},\
    {"role": "assistant", "content": "That's great! Alice is a fitness freak"},\
];
await client.add(messages, { userId: "alice" });

Search

Search for memories based on a query asynchronously.

Python

await client.search("What is Alice's favorite sport?", filters={"user_id": "alice"})

JavaScript

await client.search("What is Alice's favorite sport?", { filters: { userId: "alice" } });

Get All

Retrieve all memories for a user asynchronously.

get_all() now requires filters to be specified.

Python

await client.get_all(filters={"AND": [{"user_id": "alice"}]})

JavaScript

await client.getAll({ filters: {"AND": [{"user_id": "alice"}]} });

Delete

Delete a specific memory asynchronously.

Python

await client.delete(memory_id="memory-id-here")

JavaScript

await client.delete("memory-id-here");

Delete All

Delete all memories for a user asynchronously.

Python

await client.delete_all(user_id="alice")

JavaScript

await client.deleteAll({ userId: "alice" });

At least one filter (user_id, agent_id, app_id, or run_id) is required: calling delete_all with no filters raises an error to prevent accidental data loss. You can pass "*" as a value to delete all memories for a given entity type (e.g., user_id="*" removes memories for every user). A full project wipe requires all four filters set to "*".

History

Get the history of a specific memory asynchronously.

Python

await client.history(memory_id="memory-id-here")

JavaScript

await client.history("memory-id-here");

Users

Get all users, agents, and runs which have memories associated with them asynchronously.

Python

await client.users()

JavaScript

await client.users();

Reset

Reset the client, deleting all users and memories asynchronously.

Python

await client.reset()

JavaScript

await client.reset();

Conclusion

The AsyncMemoryClient provides a powerful way to interact with the Mem0 API asynchronously, allowing for more efficient and responsive applications. By using this client, you can perform memory operations without blocking your application’s execution.