Back to packageRELEASE DETAILS

0.1.0

PyPI

aimemoryapi

Official Python SDK for AI Memory API

Published29 Apr 2026

Direct dependencies5

Transitive dependenciesNot calculated

README

Version 0.1.0 documentation

AI Memory Python SDK

Official Python SDK for AI Memory API — persistent memory for AI agents.

Installation

pip install aimemoryapi

Quick Start

from aimemoryapi import AiMemory

client = AiMemory()

# Register a user (starts 7-day free trial)
user = client.users.register(
    user_id="my_user_001",
    email="user@example.com",
)

# Create a project
project = client.projects.create(
    user_id="my_user_001",
    name="My AI Project",
)

# Start a session
session = client.sessions.start(
    user_id="my_user_001",
    project_id=project["id"],
)

# Add messages
client.messages.add(
    session_id=session["id"],
    role="user",
    content="Hello, AI!",
)

# Retrieve session context
full_session = client.sessions.get(session["id"])
print(f"Messages: {full_session['messageCount']}")

Resources

Resource	Method	API Endpoint
`health`	`check()`	`GET /health`
`metrics`	`get()`	`GET /metrics`
`tiers`	`list()`	`GET /api/tiers`
`users`	`register()`	`POST /api/register`
`trial`	`status()`	`GET /api/trial/status/:id`
`trial`	`checkout()`	`POST /api/trial/checkout`
`projects`	`create()`	`POST /api/project`
`sessions`	`start()`	`POST /api/session`
`sessions`	`get()`	`GET /api/session/:id`
`messages`	`add()`	`POST /api/message`

Error Handling

from aimemoryapi.errors import (
    AuthenticationError,
    InvalidRequestError,
    APIError,
)

try:
    client.users.register(user_id="user_1")
except AuthenticationError as e:
    print(f"Auth error: {e}")
except InvalidRequestError as e:
    print(f"Invalid request: {e}")
except APIError as e:
    print(f"Server error: {e}")

Requirements

Python 3.8+
requests >= 2.31.0
pydantic >= 2.0.0

Downloads & popularity

Awaiting observations

No metric observations yet

Download counts and popularity will appear here as the collector receives them.

Declared dependencies 5

Native requirements

5 direct targetsNot calculated transitive count

Package / target	Requirement	Relationship
pydantic Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`pydantic>=2.0.0`	runtime
requests Environment { "extras": "", "marker": null, "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`requests>=2.31.0`	runtime
mypy Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`mypy>=1.0; extra == "dev"`	runtime
pytest-mock Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`pytest-mock>=3.12; extra == "dev"`	runtime
pytest Environment { "extras": "", "marker": "extra == \"dev\"", "requires_python": ">=3.8", "evaluation": "NOT_EVALUATED" }	`pytest>=8.0; extra == "dev"`	runtime

Distribution files

2 collected

aimemoryapi-0.1.0-py3-none-any.whl

bdist_wheel · 6.76 KB · Python py3

Source file

aimemoryapi-0.1.0.tar.gz

sdist · 6.22 KB · Python source

Source file

Metadata history

Meaningful changes

Current collected state Current

Observed since 21 Oct, 11:17 UTC

No superseded metadata states collected. Unchanged observations do not create new revisions.

Record identity

package_version:0057b44efa7c13042fc78525ee3e2afa0e21bc9e2f258efe79ecf11073de11cd

Other collected versions

View all collected versions →