Kinnoo agent CLI and scaffolding tools
Project description
Kinnoo
Kinnoo is a CLI-first platform for packaging, sharing, and installing AI agents with explicit manifest and trust controls.
Kinnoo is the lifecycle, security, and distribution harness for AI agents: define a standard manifest, package reproducible artifacts, enforce trust checks, and distribute through a registry so agents can be installed and run consistently across environments.
It is designed for AI agent developers building CLI-runnable agents who need one reliable control plane across local development and registry distribution. Kinnoo provides a standard manifest contract (kinnoo.yaml), reproducible archive workflows (.kno), trust gates for publish/install, and consistent install/run paths for end users.
What Kinnoo Is
- Strong lifecycle harness: scaffold, run, test, inspect, pack, fetch, publish, install, and uninstall with one CLI.
- Strong contract harness:
kinnoo.yamlprovides a framework-agnostic manifest with validation and predictable runtime expectations. - Strong trust harness: integrity verification, optional signing, strict trust gates, and inspection-first workflows before install/run.
- Strong distribution harness: registry auth, publish/search/list/install flows, and versioned artifact distribution for teams.
- Framework portability: build and ship agents across common framework families with consistent packaging and operator UX.
What Kinnoo Is Not
- Not a foundation model or model-hosting service.
- Not a replacement for framework-level orchestration (planner logic, tool routing, memory/retrieval strategy).
- Not a UI-only chatbot builder; Kinnoo focuses on CLI-runnable agent lifecycle workflows.
- Not a guarantee of agent quality by itself; it gives reproducibility and trust controls and provides a framework for running tests on your agents, but evaluation quality still depends on your tests and runtime design.
Installation
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip
pip install kinnoo
Quick Start
kinnoo init chatgpt my-agent
kinnoo run ./my-agent "hello"
kinnoo pack ./my-agent
kinnoo login
kinnoo publish ./my-agent --pack --strict --remote
Documentation
docs/getting-started.mddocs/registry-guide.mddocs/kinnoo-yaml-spec.mddocs/cli-reference.mddocs/security-model.mddocs/supported-agents.md
Supported Frameworks
Kinnoo currently scaffolds and runs agent templates for these framework families:
- generic (no framework)
- chatgpt
- gemini
- claude-chat
- pydantic-ai
- langgraph
- openai-agents
- mcp-client
- mcp-server
- openclaw
See docs/supported-agents.md for capability matrix details.
Contributing
Contributions are welcome. See CONTRIBUTING.md for development and contribution workflow.
License
MIT (LICENSE).
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file kinnoo-0.7.7.tar.gz.
File metadata
- Download URL: kinnoo-0.7.7.tar.gz
- Upload date:
- Size: 177.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
06a3bc78adf1b5a7d1ba592315390112040164c763f77af283d228b40f347244
|
|
| MD5 |
9d26db894d022c20542025eebdba6ade
|
|
| BLAKE2b-256 |
2889e8875d39c521e9de5b92b2d7195fa6160e6d26033366a312df7cba2eae1d
|
File details
Details for the file kinnoo-0.7.7-py3-none-any.whl.
File metadata
- Download URL: kinnoo-0.7.7-py3-none-any.whl
- Upload date:
- Size: 195.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.3
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e20cee22759cba75438fb7829a1f00039ac94f65ca6364a61d3bf15f20dea2d0
|
|
| MD5 |
ac6f75806418cf3d549c08c03be190d2
|
|
| BLAKE2b-256 |
0f5b262f91d7f216ae46e723921c28f61c076f9eeaf0d0d94758cfa39e396b64
|