katonic-sdk

The Python SDK for the Katonic 7.0 platform: the public API client (KatonicClient), agent authoring, blueprint scaffolding, multi-agent composition, and local evaluation.

pip install "katonic-sdk>=7"
# or pin it to the version of the platform you deploy (X.Y.Z):
pip install "katonic-sdk==X.Y.Z"

Sovereign / air-gapped installs: download the wheel from your deployment's Developer Hub instead.

Quickstart

export KATONIC_BASE_URL=https://<your-studio-host>   # the host; the client adds /public/v1
export KATONIC_API_KEY=kapi_...                      # Studio > Public API > API keys

import asyncio
from katonic import KatonicClient

async def main():
    async with KatonicClient() as k:  # reads KATONIC_API_KEY / KATONIC_BASE_URL
        agent = (await k.list_agents())[0]  # published agents; chat takes the agent's id
        resp = await k.chat(agent.id, "What is the PTO policy?")
        print(resp.message.content)

asyncio.run(main())

The katonic command ships with the package (katonic login, katonic agents list, katonic search … — see katonic --help).

What the client covers

KatonicClient wraps the platform's public API, one async method per call:

Each call needs the matching scope on the key. A few are refused by the platform whatever the key holds, while the public API does not yet allow them: creating knowledge sources, uploading documents, and creating, changing, validating or deleting graph schemas.

The rest of the package authors agents offline, with no platform:

• katonic.gateway, katonic.knowledge, katonic.guardrails and katonic.tools build an agent's bindings;
• katonic.compose wires sub-agents into NAT workflows;
• katonic.scaffold writes blueprint packages;
• katonic.evaluate writes local evaluation configs;
• katonic.connectors is the base class for custom knowledge connectors.

Naming, versioning, and one caveat

• Distribution name: katonic-sdk, from 7.x (this package). The 6.x releases under the same name are Katonic's legacy MLOps SDK, a different API: pin katonic-sdk<7 if you still need it. Earlier 7.x documentation called this package katonic-platform; it was never published under that name.
• Import name: import katonic. The legacy katonic 6.2.0 package owns the same import name — installing both in one environment is a silent module collision. Keep them in separate environments.
• Versioning: the SDK is released with the platform, at the platform's version: platform vX.Y.Z is katonic-sdk==X.Y.Z. Development builds, X.Y.Z.devN, are published to TestPyPI only. Install the version that matches your deployment. A newer SDK can call routes that an older platform does not have.

Support

Issues and questions go through your Katonic support channel; the API reference lives in your deployment's Developer Hub.