Python SDK — Installation

The official Memic Python SDK is published on PyPI as memic.

Install

pip install memic

Requires Python 3.10 or newer.

Authenticate

The SDK reads your API key from the MEMIC_API_KEY environment variable:

export MEMIC_API_KEY="mk_live_..."

from memic import Memic

client = Memic()  # reads MEMIC_API_KEY from env

Or pass it explicitly:

client = Memic(api_key="mk_live_...")

First call

print(client.me())

If this prints your org and project info, you’re good.

What’s in the SDK

The Memic client exposes these resources:

client.me() — return the context resolved from your API key
client.projects — list projects
client.files — upload, list, delete, status
client.search(query) — semantic search
client.chat(messages) — grounded chat with citations
client.prompts — fetch managed prompts

See the full reference for every method and parameter.

Configuration

The Memic constructor accepts optional parameters:

client = Memic(
    api_key="mk_live_...",           # default: MEMIC_API_KEY env var
    base_url="https://api.memic.ai/api/v1",  # default
    timeout=30.0,                    # default, in seconds
    max_retries=3,                   # default
)

Error handling

The SDK raises typed exceptions for common failures:

from memic import Memic, AuthenticationError, NotFoundError, RateLimitError

client = Memic()

try:
    client.search("test")
except AuthenticationError:
    print("Check your API key")
except RateLimitError as e:
    print(f"Rate limited, retry after {e.retry_after}s")
except NotFoundError as e:
    print(f"Not found: {e}")

Quickstart

5-minute walkthrough.

Full reference

Every method and parameter.

​Install

​Authenticate

​First call

​What’s in the SDK

​Configuration

​Error handling

​Related