Metadata-Version: 2.5
Name: kernos-sdk
Version: 0.1.0
Summary: Reasoning worker, kernel client and evaluation harness for Kernos.
Project-URL: Homepage, https://github.com/rhs2/kernos
Project-URL: Documentation, https://rhs2.github.io/kernos/reference/python-sdk/
Author: Kernos contributors
License-Expression: Apache-2.0
Keywords: agents,automation,kernos,worker
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Typing :: Typed
Requires-Python: >=3.10
Requires-Dist: httpx==0.28.1
Requires-Dist: jsonschema==4.26.0
Requires-Dist: pydantic==2.13.5
Provides-Extra: anthropic
Requires-Dist: anthropic<2,>=1.3.0; extra == 'anthropic'
Provides-Extra: dev
Requires-Dist: build==1.6.0; extra == 'dev'
Requires-Dist: mypy==2.3.1; extra == 'dev'
Requires-Dist: pytest==9.1.1; extra == 'dev'
Requires-Dist: ruff==0.16.6; extra == 'dev'
Description-Content-Type: text/markdown

# kernos-sdk

The Python part of [Kernos](https://github.com/rhs2/kernos): the reasoning worker
that leases steps from the kernel and executes them, a typed client for the kernel
and gateway HTTP APIs, the model router and providers, and the evaluation harness
that gates promotions.

```bash
pip install kernos-sdk            # mock provider only
pip install "kernos-sdk[anthropic]"

kernos-worker --kernel http://127.0.0.1:7401 --gateway http://127.0.0.1:7402 \
              --provider mock --worker-id wrk-a1 --concurrency 4

kernos-eval run --golden golden/ --kernel http://127.0.0.1:7401 \
                --gateway http://127.0.0.1:7402 --provider mock --out report.json
kernos-eval gate --baseline base.json --candidate cand.json
```

```python
from kernos import GatewayClient, KernelClient, ModelRouter, Worker, providers
from kernos.eval import gate, run_golden
from kernos.templating import render, resolve_refs
```

The contracts this package implements are documented at https://rhs2.github.io/kernos/reference/.
specification is silent are listed in `NOTES.md`.

Every environment variable has a flag equivalent: `KERNOS_KERNEL_URL`,
`KERNOS_GATEWAY_URL`, `KERNOS_TOKEN`, `KERNOS_PROVIDER`, `KERNOS_MODEL_DEEP`,
`KERNOS_MODEL_STANDARD`, `KERNOS_MODEL_CHEAP`, `KERNOS_PRICING_JSON`,
`KERNOS_MOCK_REFUSE`, `KERNOS_MOCK_CONFIDENCE`, `KERNOS_LOG`.

Licensed under Apache 2.0.
