> This page is also available as Markdown: append .md to its URL. The full index of Sikaru docs is at https://docs.sikaru.ai/llms.txt. Code examples use only operations from the public API reference at https://docs.sikaru.ai/api-reference.

# SDKs

The [Sikaru SDK repository](https://github.com/aadi-labs/sikaru-sdk) contains the Python and TypeScript clients. Each client calls the Sikaru API. Installing a client does not start an agent or attach your computer as an executor.

| Language   | Package       | Source                                                                     |
| ---------- | ------------- | -------------------------------------------------------------------------- |
| Python     | `sikaru_api`  | [Python](https://github.com/aadi-labs/sikaru-sdk/tree/main/python)         |
| TypeScript | `@sikaru/sdk` | [TypeScript](https://github.com/aadi-labs/sikaru-sdk/tree/main/typescript) |

## Install

#### Python

Requires Python 3.10 or later. Add the client to your project with [uv](https://docs.astral.sh/uv/):

```sh
uv add sikaru_api
```

Import `SikaruApi` from `sikaru_api`.

#### TypeScript

Requires Node.js 18 or later:

```sh
npm install @sikaru/sdk
```

Import `SikaruApi` from `@sikaru/sdk` in server-side code.

Your lockfile (`uv.lock` or `package-lock.json`) pins the client version, so builds use a known client contract. Read the changelog when you upgrade. Newly documented endpoints also need a service version that supports them.

> **Warning**
>
> Keep `SIKARU_API_KEY` in your server or terminal environment. Never embed it in a browser bundle. Configure the API base URL for the Sikaru environment your account uses.

## Make reliable requests

* Automatic retries are limited to GET and HEAD requests.
* Mutations are not automatically retried.
* Keep idempotency keys and receipts when the API operation provides them.
* Reconcile an uncertain acknowledgement before you repeat an operation with external effects.

The [Quickstart](/get-started/quickstart) shows both clients. Each language directory in the [SDK repository](https://github.com/aadi-labs/sikaru-sdk) includes its full method reference.

## Next steps

#### [SDK configuration](/sdks-and-cli/sdk-configuration)

Timeouts, errors, async clients, and pagination.

#### [Quickstart](/get-started/quickstart)

Run your first agent with the Python client.