SDK
Management Client
Use KateClient to programmatically manage agents, artifacts, discovery, and more.
KateClient is the main entry point for interacting with the Kate platform programmatically. It provides sub-clients for each domain.
Constructor
from projectkate import KateClient
client = KateClient(
api_key="your-api-key",
base_url="https://api.projectkate.com", # default
timeout=30.0, # default, in seconds
)| Parameter | Type | Default | Description |
|---|---|---|---|
api_key | str | required | Your Kate API key |
base_url | str | "https://api.projectkate.com" | Platform API URL |
timeout | float | 30.0 | Request timeout in seconds |
Context Manager
Always use KateClient as an async context manager to ensure the HTTP client is properly closed:
async with KateClient(api_key="your-api-key") as client:
agents = await client.agents.list()
# client is automatically closed when the block exitsOr manually close:
client = KateClient(api_key="your-api-key")
try:
agents = await client.agents.list()
finally:
await client.close()Sub-Clients
Access sub-clients as properties on the client instance. They're lazily initialized on first access.
async with KateClient(api_key="your-api-key") as client:
# Agent management
agents = await client.agents.list()
# Artifact management
artifacts = await client.artifacts.list()
# Discovery configuration
config = await client.discovery.configure(agent_id="...")
# Knowledge briefs
brief = await client.briefs.get(agent_id="...")
# Token wallet
ledger = await client.wallet.ledger()
# Evaluations
summary = await client.evals.summary(agent_id="...")
# Runs
runs = await client.runs.list(agent_id="...")| Property | Type | Purpose |
|---|---|---|
client.agents | AgentsClient | Create, list, update, delete agents |
client.artifacts | ArtifactsClient | Create, upload, publish, query artifacts |
client.briefs | BriefsClient | View knowledge briefs and diffs |
client.discovery | DiscoveryClient | Configure and run discovery |
client.wallet | WalletClient | Check balance and transaction history |
client.evals | EvalsClient | View evaluation results and trends |
client.runs | RunsClient | Create and manage agent runs |
Next Steps
- Agents Client - agent CRUD operations
- Artifacts Client - artifact lifecycle
- Discovery Client - discovery configuration and execution