client/differences.md
client/differences.mdBrowse 14 files
1,307 tokens
4,978 bytes
Token encoding: o200k_base
Snapshot 0df3e4b
← Back to SKILL.md
Python vs TypeScript SDK Differences
Quick-reference cheatsheet for developers working across both Mem0 SDKs.
Constructor
| Aspect | Python | TypeScript |
|---|---|---|
| Import (Platform) | from mem0 import MemoryClient | import MemoryClient from 'mem0ai' |
| Import (OSS) | from mem0 import Memory | import { Memory } from 'mem0ai/oss' |
| Constructor | MemoryClient(api_key="m0-xxx") | new MemoryClient({ apiKey: 'm0-xxx' }) |
| Required param | api_key (positional or kwarg) | apiKey (in options object) |
Both read from MEM0_API_KEY env var if no key provided.
Method Naming
| Operation | Python | TypeScript |
|---|---|---|
| Add | add() | add() |
| Search | search() | search() |
| Get | get() | get() |
| Get all | get_all() | getAll() |
| Update | update() | update() |
| Delete | delete() | delete() |
| Delete all | delete_all() | deleteAll() |
| History | history() | history() |
| Batch update | batch_update() | batchUpdate() |
| Batch delete | batch_delete() | batchDelete() |
| List users | users() | users() |
| Delete users | delete_users() | deleteUsers() |
| Get project | project.get() | getProject() |
| Update project | project.update() | updateProject() |
| Create webhook | create_webhook() | createWebhook() |
| Get webhooks | get_webhooks() | getWebhooks() |
| Update webhook | update_webhook() | updateWebhook() |
| Delete webhook | delete_webhook() | deleteWebhook() |
| Create export | create_memory_export() | createMemoryExport() |
| Get export | get_memory_export() | getMemoryExport() |
| Feedback | feedback() | feedback() |
Rule: Python uses snake_case, TypeScript uses camelCase for method names.
Parameter Passing
# Python: kwargs
client.add(messages, user_id="alice", metadata={"source": "chat"})
client.search("query", filters={"user_id": "alice"}, top_k=5, rerank=True)// TypeScript: options object with camelCase for top-level params, snake_case for filter keys
await client.add(messages, { userId: 'alice', metadata: { source: 'chat' } });
await client.search('query', { filters: { user_id: 'alice' }, topK: 5, rerank: true });v3: Python uses snake_case everywhere. TypeScript uses camelCase for top-level params (userId, topK) but snake_case for filter keys (user_id, agent_id).
Architectural Differences
| Aspect | Python | TypeScript |
|---|---|---|
| HTTP library | httpx | axios |
| Default timeout | 300s | 60s |
| Sync support | Yes (MemoryClient) | No (all async) |
| Async support | Yes (AsyncMemoryClient) | All methods are async |
| Project management | client.project.* (separate class) | client.getProject() / client.updateProject() |
| Context manager | async with AsyncMemoryClient() | Not supported |
Platform Features: Python-only
These methods exist in Python but not TypeScript:
| Method | Description |
|---|---|
get_summary(filters) | Get summary of memories |
reset() | Delete ALL data (users + memories) |
project.create(name) | Create a new project |
project.delete() | Delete current project |
project.get_members() | List project members |
project.add_member(email, role) | Add member to project |
project.update_member(email, role) | Change member role |
project.remove_member(email) | Remove member |
Platform Features: TypeScript-only
| Method | Description |
|---|---|
deleteUser(data) | Convenience method for single entity deletion |
ping() | Health check endpoint |
OSS Config Naming
| Python config key | TypeScript config key |
|---|---|
vector_store | vectorStore |
history_db_path | historyDbPath |
custom_instructions | customInstructions |
OSS Scope Parameter Naming
| Python | TypeScript |
|---|---|
user_id="alice" | userId: 'alice' |
agent_id="bot" | agentId: 'bot' |
run_id="session" | runId: 'session' |
Entity ID Passing (v3)
| Method | Python | TypeScript |
|---|---|---|
| add() | Top-level: user_id="alice" | Top-level: { userId: 'alice' } |
| search() | In filters: filters={"user_id": "alice"} | In filters: { filters: { user_id: 'alice' } } |
| get_all() | In filters: filters={"user_id": "alice"} | In filters: { filters: { user_id: 'alice' } } |
Common Gotcha
When searching/filtering, both Python and TypeScript use snake_case for filter keys. TypeScript only uses camelCase for top-level method parameters:
# Python - snake_case in filters
results = client.search("query", filters={"user_id": "alice"})// TypeScript - snake_case in filters, camelCase for top-level params
const results = await client.search('query', { filters: { user_id: 'alice' }, topK: 20 });