Metadata-Version: 2.4
Name: pastdotdev
Version: 0.0.1
Summary: Official SDK for the past.dev Memory API
Author-email: Past Corp <hello@past.dev>
License: MIT
Project-URL: Homepage, https://past.dev
Project-URL: Repository, https://github.com/pastdotdev/pastdotdev
Keywords: past.dev,memory,api,sdk
Classifier: Development Status :: 3 - Alpha
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.9
Description-Content-Type: text/markdown

# pastdotdev

Official SDK for the [past.dev](https://past.dev) Memory API.

This package is the reserved official Python client published by Past Corp.
Install it as `pastdotdev` — the brand is **past.dev** (with the dot), never a
bare "past".

## Install

```bash
pip install pastdotdev
```

## Usage

```python
from pastdotdev import PastClient

client = PastClient(api_key="...", base_url="https://api.past.dev")

client.ingest({
    "content": "Nadia confirmed the pilot ships March 14. Budget is 32k.",
    "timestamp": "2026-02-03T09:00:00Z",
    "group": "acme-pilot",
})

evidence = client.recall({"query": "what is the Acme pilot budget?"})
result = client.answer({"query": "what is the Acme pilot budget?"})
```

`ingest` POSTs `/api/v1/ingest`. Pass an ingestion id (or `{"id": "..."}`
without `content`) to GET `/api/v1/ingest/{id}` and poll until `settled` is
true. `recall` and `answer` POST `/api/v1/recall` and `/api/v1/answer`.

Homepage: https://past.dev

This 0.0.1 release is the reserved official package. The Memory API is in
early access; request a key at https://past.dev.
