Skip to main content

Kyvvu Python client

Enforce policies before your Python agent acts, and record the decisions in its audit trail. Kyvvu maps agent events to behaviours, evaluates them against the task's history, and allows, warns, or blocks each step. Each behaviour's kind identifies its action, such as a model call, resource access, or decision gate.

Quickstart

Install the kyvvu command and run the bundled offline trial. The trial needs no account or API key:

uv tool install kyvvu-cli    # or: pip install kyvvu-cli
kyvvu try

Install this package, the Python client, in your agent's project:

pip install kyvvu    # or: uv add kyvvu

To connect an agent to the platform, sign in, create an agent API key under Workspace → API Keys in the dashboard, and follow the scaffold's setup:

kyvvu auth
kyvvu init my-agent
cd my-agent
python agent.py

The first-agent guide explains credentials, tool declarations, task boundaries, and the resulting warnings and blocks. To expose the engine over HTTP, use kyvvu serve from kyvvu-cli and follow the local-server guide.

Choose an integration

Agent Package and import Guide
Custom Python functions kyvvu, from kyvvu import Kyvvu Decorator integration
LangChain or LangGraph kyvvu-langchain, kyvvu_langchain LangChain and LangGraph
CrewAI kyvvu-crewai, kyvvu_crewai CrewAI
Other languages kyvvu serve, HTTP REST integration

Use agent_version= and framework= on Kyvvu(...) to identify the client in its task trace. The configuration reference and task guide describe settings, explicit task selection, and lifecycle rules. For programmatic recording, see add_step; for matching and extending events, see behaviour templates.

Documentation and support

Run kyvvu docs for the documentation matching each installed package, or kyvvu explain step_requires_gate for an installed rule's contract. Validate a local manifest offline with kyvvu schema manifest --validate policies.yaml.

The Python client is Apache-2.0 licensed. Its runtime dependency kyvvu-engine is source-available under BSL 1.1; the Python client's license does not extend to the engine. See licensing for the terms and pricing for commercial use.

Metadata

Release files for kyvvu 1.0.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for kyvvu 1.0.0
File Size Uploaded Provenance Actions
kyvvu-1.0.0.tar.gz 208.3 kB Without provenance Details for kyvvu-1.0.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for kyvvu 1.0.0
File Interpreter ABI Platform Actions
kyvvu-1.0.0-py3-none-any.whl Python 3 none any Details for kyvvu-1.0.0-py3-none-any.whl

Total release size: 264.8 kB

Release files / kyvvu-1.0.0.tar.gz

Download URL kyvvu-1.0.0.tar.gz
Size 208.3 kB
Tags Source
SHA-256 checksum
How to use checksums
c82925236d0390dcfb256679a85d47c407e01d054293775f0ac5bd1368e037cc
BLAKE2b-256 checksum
How to use checksums
f867821e7bd393ab3be6b75a29d72592f71bef9202fb449aa38049c1bb4c9b33
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Release files / kyvvu-1.0.0-py3-none-any.whl

Download URL kyvvu-1.0.0-py3-none-any.whl
Size 56.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
8ce78621e5145f838c7d04dc0bb7dd2a76f41ddbbdb8718b371598f57045061b
BLAKE2b-256 checksum
How to use checksums
c4a4207a0d4357e6a3777fa21742e33b0b5f6f0474fa3803930e95cf74e12505
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.5 {"installer":{"name":"uv","version":"0.12.5","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"26.04","id":"resolute","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

Security for kyvvu 1.0.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page