Metadata-Version: 2.4
Name: kyvvu
Version: 1.0.0
Summary: Kyvvu Python client: instrument an agent and evaluate its actions with the Kyvvu engine
Author-email: "Kyvvu B.V." <info@kyvvu.com>
License: Copyright 2026 Kyvvu B.V.
        
        Licensed under the Apache License, Version 2.0 (the "License");
        you may not use this file except in compliance with the License.
        You may obtain a copy of the License at
        
        http://www.apache.org/licenses/LICENSE-2.0
        
        Unless required by applicable law or agreed to in writing, software
        distributed under the License is distributed on an "AS IS" BASIS,
        WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
        See the License for the specific language governing permissions and
        limitations under the License.
        
        This license applies only to the contents of the kyvvu-sdk/ directory
        of the Kyvvu monorepo. Other directories in this monorepo are governed
        by their own LICENSE files.
Project-URL: Documentation, https://docs.kyvvu.com/
Project-URL: Changelog, https://docs.kyvvu.com/reference/changelog
Project-URL: Issues, https://github.com/Kyvvu/issues/issues
Keywords: ai,compliance,eu-ai-act,monitoring,logging,policy-enforcement
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: kyvvu-engine<2.0.0,>=1.0.0
Requires-Dist: kyvvu-baseline<2.0.0,>=1.0.0
Requires-Dist: kyvvu-templates<2.0.0,>=1.0.0
Requires-Dist: pyyaml>=6.0
Provides-Extra: dev
Requires-Dist: pytest>=7.4.0; extra == "dev"
Requires-Dist: pytest-cov>=4.1.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.21.0; extra == "dev"
Requires-Dist: jsonschema<5,>=4.23; extra == "dev"
Requires-Dist: rfc3339-validator>=0.1.4; extra == "dev"
Requires-Dist: ruff>=0.16.9; extra == "dev"
Requires-Dist: mypy>=1.0.0; extra == "dev"
Requires-Dist: types-PyYAML>=6.0; extra == "dev"
Dynamic: license-file

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

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

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

```bash
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:

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

The [first-agent guide](https://docs.kyvvu.com/getting-started/first-agent)
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](https://docs.kyvvu.com/cli/serve).

## Choose an integration

| Agent | Package and import | Guide |
| --- | --- | --- |
| Custom Python functions | `kyvvu`, `from kyvvu import Kyvvu` | [Decorator integration](https://docs.kyvvu.com/integrations/decorator) |
| LangChain or LangGraph | `kyvvu-langchain`, `kyvvu_langchain` | [LangChain and LangGraph](https://docs.kyvvu.com/integrations/langchain) |
| CrewAI | `kyvvu-crewai`, `kyvvu_crewai` | [CrewAI](https://docs.kyvvu.com/integrations/crewai) |
| Other languages | `kyvvu serve`, HTTP | [REST integration](https://docs.kyvvu.com/integrations/rest-api) |

Use `agent_version=` and `framework=` on `Kyvvu(...)` to identify the client in
its task trace. The [configuration reference](https://docs.kyvvu.com/deployment/configuration)
and [task guide](https://docs.kyvvu.com/concepts/tasks) describe settings,
explicit task selection, and lifecycle rules. For programmatic recording, see
[add_step](https://docs.kyvvu.com/reference/add-step); for matching and extending
events, see [behaviour templates](https://docs.kyvvu.com/concepts/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`.

- [Documentation](https://docs.kyvvu.com/)
- [CLI guides](https://docs.kyvvu.com/cli/init)
- [Interface stability](https://docs.kyvvu.com/reference/stability)
- [Changelog](https://docs.kyvvu.com/reference/changelog)
- [Trace export and provenance](https://docs.kyvvu.com/reference/trace-export)
- [Report an issue](https://github.com/Kyvvu/issues/issues)

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](https://docs.kyvvu.com/reference/licensing) for the terms and
[pricing](https://kyvvu.com/pricing) for commercial use.
