supermemory

What it is and what it does

Supermemory is an official Python SDK for the Supermemory REST API, generated using Stainless. It provides a typed client interface for interacting with Supermemory's document storage and search capabilities. The library includes full type definitions for request parameters and response fields, enabling IDE autocomplete and type checking. It offers both synchronous (Supermemory) and asynchronous (AsyncSupermemory) clients, both powered by httpx.

The package handles common API concerns: automatic retries for transient failures (2 retries by default for connection errors, timeouts, rate limits, and server errors), configurable timeouts, and detailed error handling with specific exception types for different HTTP status codes. Responses are Pydantic models with helper methods for JSON serialization and dictionary conversion. The async client can optionally use aiohttp as its HTTP backend for improved concurrency performance.

Use it for:

• Search and retrieve documents from Supermemory using natural language queries within a Python application
• Build a memory management system that stores, updates, and retrieves user-specific information with temporal context
• Integrate Supermemory into an async Python service for non-blocking document uploads and searches
• Implement error handling and retry logic for API calls to Supermemory with automatic backoff
• Use typed request/response objects to catch API integration bugs early via static type checking

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides a Python client library for the Supermemory REST API with full type hints, supporting both synchronous and asynchronous operations.

Yes. The package is actively maintained, has no known vulnerabilities, uses permissive licensing, and offers low installation friction. It is suitable for any Python 3.9+ project needing to integrate with Supermemory. The typed interface and built-in error handling reduce integration friction. The main prerequisite is a valid Supermemory API key.

Install

supermemory on PyPI

pip install supermemory

uv add supermemory

poetry add supermemory

Installing supermemory

Before you install

Low friction installation with a pure Python wheel. Actively maintained with a recent release and no known vulnerabilities. Depends on common, well-maintained libraries (httpx, pydantic, anyio).

License in practice

Licensed under Apache-2.0 (permissive), allowing free use in commercial and private projects with minimal restrictions.

Quickstart

pip install supermemory

import os
from supermemory import Supermemory

client = Supermemory(api_key=os.environ.get("SUPERMEMORY_API_KEY"))
response = client.search.documents(q="documents related to python")
print(response.results)

Requires a valid Supermemory API key set via SUPERMEMORY_API_KEY environment variable or passed directly to the client.

Verify before relying

• Whether the library is feature-complete relative to the full Supermemory REST API as of version 3.59.0
• Performance characteristics and rate-limit handling behavior under high concurrency
• Whether aiohttp backend provides measurable concurrency improvements for typical workloads

Package facts

Evidence: supermemory-3.59.0-py3-none-any.whl

Tags

More Python Modules packages