> For the complete documentation index, see [llms.txt](https://docs.kyvvu.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kyvvu.com/getting-started/installation.md).

# 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.

{% hint style="info" %}
**Instant access:** Registration is immediate — no email verification step. Your account is active as soon as you register. Organization founders get full access instantly; team members joining an existing org need admin verification.
{% endhint %}

## Verify

```bash
kyvvu whoami
```

```
Email:         you@company.com
API URL:       https://platform.kyvvu.com
Verification:  ✓ verified
Log location:  stdout
Incidents:     (inherits log location: stdout)
```

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

```
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.