kneo-serv 0.5.0

Service and control-plane platform built on the kneo-agent SDK

kneo-serv

Service and control-plane platform built on the 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

pip install kneo-serv

For deployments needing PostgreSQL persistence and OpenTelemetry:

pip install 'kneo-serv[deploy]'

Both paths install the kneo command.

Quickstart

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

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.