> For the complete documentation index, see [llms.txt](https://docs.zenml.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.zenml.io/sdk-reference/kitaru/client.md).

# Client

[Kitaru](https://docs.zenml.io/kitaru) is ZenML's sibling project for running, replaying, and improving AI agents. `KitaruClient` is the programmatic interface to a Kitaru server — inspect and control flow executions, browse artifacts, invoke deployments, and manage authentication from Python.

This page groups the client into thematic areas. For the complete, auto-generated API (every method and signature), see the [full Kitaru SDK reference](https://sdkdocs.kitaru.ai/reference/python/client/).

```python
import kitaru

client = kitaru.KitaruClient()
```

The client exposes its functionality through sub-APIs accessed as attributes.

## Executions

[`client.executions`](https://sdkdocs.kitaru.ai/reference/python/client/) inspects and controls flow executions:

* [`get`](https://sdkdocs.kitaru.ai/reference/python/client/) — fetch a single execution by ID
* [`list`](https://sdkdocs.kitaru.ai/reference/python/client/) — list executions
* [`latest`](https://sdkdocs.kitaru.ai/reference/python/client/) — the most recent execution
* [`logs`](https://sdkdocs.kitaru.ai/reference/python/client/) — retrieve runtime logs for an execution
* [`input`](https://sdkdocs.kitaru.ai/reference/python/client/) — provide input to an execution waiting on `kitaru.wait()`
* [`resume`](https://sdkdocs.kitaru.ai/reference/python/client/) — resume a waiting execution after input lands
* [`retry`](https://sdkdocs.kitaru.ai/reference/python/client/) — retry a failed execution
* [`cancel`](https://sdkdocs.kitaru.ai/reference/python/client/) — cancel a running execution
* [`replay`](https://sdkdocs.kitaru.ai/reference/python/client/) — replay from a checkpoint, optionally overriding cached outputs

## Artifacts

[`client.artifacts`](https://sdkdocs.kitaru.ai/reference/python/client/) browses and reads checkpoint outputs and saved artifacts.

## Deployments

[`client.deployments`](https://sdkdocs.kitaru.ai/reference/python/client/) invokes and inspects deployed flows:

* [`invoke`](https://sdkdocs.kitaru.ai/reference/python/client/) — start a new execution from a deployed flow (by name + tag/version)
* [`list`](https://sdkdocs.kitaru.ai/reference/python/client/) / [`get`](https://sdkdocs.kitaru.ai/reference/python/client/) — inspect available deployment routes

## Authentication

[`client.auth`](https://sdkdocs.kitaru.ai/reference/python/client/) manages service accounts and API keys for server access.

***

For complete signatures and the full method list, see the [Kitaru SDK reference](https://sdkdocs.kitaru.ai/reference/python/client/). For the command-line equivalents, see the [Kitaru CLI reference](https://sdkdocs.kitaru.ai/cli/).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.zenml.io/sdk-reference/kitaru/client.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.