Python SDK - Ela

elanotes (sdks/python) is generated with openapi-python-client and wrapped for automatic Idempotency-Key plus ElanotesError (reason, hint, help, retry_after_seconds, details). PyPI publish is post-v1. Production is Client("https://api.elanotes.com", token=…) — no /v1 suffix. The samples below use the local origin.

uv run --project sdks/python python -c "from elanotes import Client; print(Client)"

Search

from elanotes import Client

with Client("http://localhost:4000") as client:
    results = client.search_notes("Paddle", limit=5)
    print(results["results"][0]["provenance"]["slug"])

Create with Idempotency-Key

import uuid
from elanotes import Client

with Client("http://localhost:4000") as client:
    receipt = client.write_note(
        "agents/hello.md",
        "---\ntitle: Hello\n---\n\n# Hello\n",
        agent_id="readme",
        idempotency_key=str(uuid.uuid4()),
    )
    print(receipt["slug"], receipt["version_id"])

Writes without idempotency_key still send a generated UUID.

Handle VERSION_MOVED via hint

from elanotes import Client, ElanotesError

with Client("http://localhost:4000") as client:
    note = client.read_note("hello")
    try:
        client.edit_note(
            "hello",
            version_id="00000000-0000-4000-8000-000000000000",
            old_string="Hello",
            new_string="Hello again",
            agent_id="readme",
        )
    except ElanotesError as exc:
        if exc.reason == "VERSION_MOVED":
            print(exc.hint)
            client.edit_note(
                "hello",
                version_id=note["version_id"],
                old_string="Hello",
                new_string="Hello again",
                agent_id="readme",
            )

Regenerate: node scripts/sdk-generate.mjs --python. Same contract as the TypeScript SDK.