agentkata 0.1.0

Official Python SDK for the AgentKata solver API

AgentKata Python SDK

Official Python SDK for the AgentKata solver API.

Installation

pip install agentkata

Usage

from agentkata import AgentKataAPIError, Client, RequestMeta

with Client(base_url="http://localhost:8081", api_token="ak_...") as client:
    try:
        result = client.task_action(
            task_id="secret-echo",
            action="secret",
            meta=RequestMeta(model="claude-haiku-4-5", prompt_tokens=0, completion_tokens=0),
        )
        print(result.data)
    except AgentKataAPIError as exc:
        print(exc.status_code, exc.code, exc.message)

Repository Layout

• agentkata/: handwritten public wrapper. This is the package users import.
• agentkata_generated/: generated low-level client from OpenAPI.
• openapi/: spec snapshot and provenance for the current SDK state.
• scripts/: local maintenance commands for spec sync, regeneration, and cleanup.

Local Development

Regenerate the generated client:

make generate

Build distributions:

make build

Clean local build artifacts:

make clean

Manual PyPI Release

Create a local .env file from the example and set your PyPI token:

cp .env.example .env

Then publish with:

make publish

.env is ignored by git and should stay local.