kimss-sdk

Kimss Python SDK / Gateway

When to use

• Routing app traffic through Kimss (identity, audit, kill switch).
• Optional DevOps: register external agents, report BYO usage.

Preferred inference (no Kimss SDK)

Keep the native SDK already in the app.

OpenAI — pip install openai, base_url=https://api.kimss.ai/v1:

import os
from openai import OpenAI

client = OpenAI(
    base_url=os.getenv("KIMSS_GATEWAY_URL", "https://api.kimss.ai/v1"),
    api_key=os.getenv("KIMSS_API_KEY") or os.getenv("KIMSS_WORKSPACE_KEY"),
)
resp = client.chat.completions.create(
    model=os.getenv("KIMSS_MODEL", "custom:your-model"),
    messages=[{"role": "user", "content": "Hello"}],
    extra_headers={
        "X-Kimss-Agent-Id": os.getenv("KIMSS_AGENT_ID", "my_agent"),
        "X-Kimss-Agent-Name": os.getenv("KIMSS_AGENT_NAME", "My Agent"),
    },
)

Anthropic — pip install anthropic, base_url=https://api.kimss.ai (SDK appends /v1/messages):

import os
from anthropic import Anthropic

client = Anthropic(
    base_url=os.getenv("ANTHROPIC_BASE_URL", "https://api.kimss.ai"),
    api_key=os.getenv("KIMSS_API_KEY") or os.getenv("KIMSS_WORKSPACE_KEY"),
)
resp = client.messages.create(
    model=os.getenv("KIMSS_MODEL", "custom:your-model"),
    max_tokens=1024,
    messages=[{"role": "user", "content": "Hello"}],
    extra_headers={
        "X-Kimss-Agent-Id": os.getenv("KIMSS_AGENT_ID", "my_agent"),
        "X-Kimss-Agent-Name": os.getenv("KIMSS_AGENT_NAME", "My Agent"),
    },
)

See examples/00b_anthropic_proxy.py.

Control plane (optional)

pip install kimss

from kimss import KimssClient
client = KimssClient(api_key="kimss_...", base_url="https://api.kimss.ai")
client.agents.register(name="Database Auditor", agent_id="enterprise_db_auditor")

Deprecated (do not generate new call sites)

client.agents.run, client.chat, Agent.query, client.models.create, MCP kimss_chat / kimss_run_agent / kimss_complete.