---
id: supermemory
version: "3.59.0"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# supermemory — The official Python library for the supermemory API

License: permissive · Maintenance: active · Downloads: 162.8K/mo

## 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 above — 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

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

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 162.8K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

supermemory api client, python rest api library, async http client, typed api wrapper, supermemory sdk, api integration library, document search api, api-client, async-support, typed-sdk

[View on SkillFed](https://skillfed.io/packages/supermemory) · [View on PyPI](https://pypi.org/project/supermemory/)