Metadata-Version: 2.4
Name: kneo-serv
Version: 0.3.0
Summary: Service and control-plane platform built on the kneo-agent SDK
Author: Kneron, Inc. and kneo-serv contributors
License-Expression: MIT
Requires-Python: >=3.12
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: kneo-agent<2.0.0,>=1.2.0
Requires-Dist: pydantic>=2.0
Requires-Dist: pyyaml>=6.0
Requires-Dist: jsonschema>=4.0
Requires-Dist: typer>=0.12
Requires-Dist: rich>=13.0
Requires-Dist: fastapi>=0.110
Requires-Dist: uvicorn>=0.27
Requires-Dist: httpx>=0.27
Provides-Extra: dev
Requires-Dist: pytest>=8.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0; extra == "dev"
Requires-Dist: ruff>=0.8; extra == "dev"
Requires-Dist: mypy>=1.10; extra == "dev"
Requires-Dist: build>=1.2; extra == "dev"
Requires-Dist: bandit>=1.7; extra == "dev"
Requires-Dist: pip-audit>=2.7; extra == "dev"
Requires-Dist: kneo-agent[telemetry]<2.0.0,>=1.2.0; extra == "dev"
Requires-Dist: langchain-core<2.0.0,>=1.3.3; extra == "dev"
Requires-Dist: opentelemetry-sdk>=1.20; extra == "dev"
Provides-Extra: postgres
Requires-Dist: psycopg[binary]>=3.1; extra == "postgres"
Provides-Extra: telemetry
Requires-Dist: kneo-agent[telemetry]<2.0.0,>=1.2.0; extra == "telemetry"
Provides-Extra: deploy
Requires-Dist: psycopg[binary]>=3.1; extra == "deploy"
Requires-Dist: kneo-agent[telemetry]<2.0.0,>=1.2.0; extra == "deploy"
Provides-Extra: docs
Requires-Dist: mkdocs>=1.6; extra == "docs"
Requires-Dist: mkdocs-material>=9.5; extra == "docs"
Dynamic: license-file

# kneo-serv

Service and control-plane platform built on the
[kneo-agent](https://pypi.org/project/kneo-agent/) SDK. `kneo-serv` is
distributed as a Python package shipping a FastAPI service, a Typer
CLI, a YAML spec compiler, durable run state, and human-in-the-loop
pause/resume.

## Install

```bash
pip install kneo-serv
```

For deployments needing PostgreSQL persistence and OpenTelemetry:

```bash
pip install 'kneo-serv[deploy]'
```

Both paths install the `kneo` command.

## Quickstart

```bash
# Validate a YAML spec
kneo spec validate path/to/spec.yaml

# Run an agent or workflow locally
kneo run path/to/spec.yaml --input "your input"

# Start the HTTP service
kneo service serve --host 127.0.0.1 --port 8000
```

## Configuration

Project-level configuration lives in `.kneo/config.yaml`. Bootstrap
one with:

```bash
kneo config init --name my-project
```

For runtime / deployment configuration (database URL, API keys,
telemetry endpoints, retention windows, request limits), example
templates are included in the sdist under `deploy/`
(`production.env.example`, `staging.env.example`). Each variable is
documented inline in the example files.

## License

MIT.
