k9o — Kilimanjaro platform SDK (Python)

Idiomatic Python SDK. Snake_case methods; raise KError on error; data DSL via client.from_("collection").select(); typed envelope with meta accessor sugar.

Status

v0.1.0 — first-pass idiomatic ship (P3 wave 1; reshape from prior k9o_gate OpenAPI codegen).

Surfaces shipped:

• create_client(...) factory + baseUrl validation per ch13 §7
• KError(Exception) with kerror_from_wire rehydration
• Envelope + typed Meta accessor (MetaCursor / MetaSubscription / MetaIdempotency / MetaWarning / MetaTiming / MetaContext) per ch01 §1 + ch13 §5
• URL grammar v2.5.68 (validate_base_url / validate_slug / project_path / org_path / platform_path)
• Data-plane DSL: client.from_(collection) with chainable filter builder (.eq / .neq / .gt / .gte / .lt / .lte / .in_ / .not_in / .like / .ilike / .is_ / .filter) + .limit / .cursor / .count + terminal verbs (.select().execute() / .insert() / .update().eq("id", ...).execute() / .delete().eq("id", ...).execute())
• client.projects.{list,create,get,update}
• client.ai.embed(input, model=None) (platform embeddings; requires project_slug)
• client.gate.{sign_up,sign_in,sign_out,whoami,refresh_token,verify_session,hosted} (project-scoped auth)
• client.storage.{create_bucket,get_bucket,list_buckets,update_bucket,delete_bucket} and client.storage.from_(bucket).{upload,create_signed_url,list,remove} (buckets and objects; _async twins; requires project_slug; expires_in is required, 1..604800)
• Sync (request) + async (request_async) HTTP via httpx

Install

pip install k9o

(Pre-launch: install from monorepo source via pip install -e packages/python.)

Quick start

import os
from k9o import create_client, KError

k9o = create_client(
    base_url="https://acme.api.k9o.io",
    api_key=os.environ["K9O_API_KEY"],
    org_slug="acme",
    project_slug="member-portal",
)

try:
    response = k9o.from_("posts").select().limit(10).execute()
    for row in response.data:
        print(row)
    if response.meta.cursor:
        print("next cursor:", response.meta.cursor.next)

    session = k9o.gate.sign_in(email="user@example.com", password="…")
    print("signed in:", session.data["user"]["id"])
except KError as e:
    print(f"[{e.code}] {e.message}: {e.recommendation}")
    raise

Idiomatic shape (per ch13)

License

UNLICENSED — internal to Kilimanjaro.