Installation

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

---

Install the SDK

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

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: [e-mail]
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.

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.

Verify

kyvvu whoami

Email:         [e-mail]
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:

export KV_API_KEY=KvKey-...

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

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 page for details.

---

Next steps

• Your First Agent — create and run a demo agent with kyvvu init

• Architecture — understand how the SDK, engine, and platform fit together