# Installation

**What you'll learn:** How to install the Kyvvu SDK, create an account, and verify your setup.

***

## Install the SDK

```bash
pip install kyvvu
```

This installs the `kyvvu` Python package, which includes:

* The **SDK** (`kyvvu`) — decorator and callback integrations for your agent code
* The **engine** (`kyvvu-engine`) — in-process policy evaluation library
* The **CLI** (`kyvvu` command) — account management, project scaffolding, local server

## Create an account

```bash
kyvvu register
```

You'll be prompted for an email, display name, and password. On success, you'll receive an API key:

```
Registering at https://platform.kyvvu.com

Email: you@company.com
Display name: Your Name
Password:
Confirm password:

✓ Account created and verified.

Your API key (save this — it will not be shown again):

    KvKey-abc123...

Set it in your environment:

    export KV_API_KEY=KvKey-abc123...

Next steps:
    kyvvu init my-agent
```

Save the API key — it authenticates your agents with the Kyvvu platform.

## Verify

```bash
kyvvu whoami
```

```
Email:         you@company.com
API URL:       https://platform.kyvvu.com
Verification:  ✓ verified
Log endpoint:  stdout
Incidents:     not configured
```

## Environment variables

Set `KV_API_KEY` in your shell profile or `.env` file:

```bash
export KV_API_KEY=KvKey-...
```

For self-hosted deployments, also set the API URL:

```bash
export KV_API_URL=https://your-kyvvu-instance.com
```

## Licensing note

The SDK itself is licensed under Apache 2.0. It depends on `kyvvu-engine`, which is licensed under the Business Source License 1.1 (BSL 1.1). Production use of the engine requires a Kyvvu commercial subscription. See the [Licensing](/reference/licensing.md) page for details.

***

## Next steps

* [Your First Agent](/getting-started/first-agent.md) — create and run a demo agent with `kyvvu init`
* [Architecture](/core-concepts/architecture.md) — understand how the SDK, engine, and platform fit together


---

# Agent Instructions: 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:

```
GET https://docs.kyvvu.com/getting-started/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.