Metadata-Version: 2.4
Name: kinnoo
Version: 0.7.5
Summary: Kinnoo agent CLI and scaffolding tools
Author-email: Jerry Chen <jerryschen@gmail.com>
License-Expression: MIT
Project-URL: Homepage, https://github.com/jerryjliu/kinnoo
Project-URL: Documentation, https://github.com/jerryjliu/kinnoo/tree/master/docs
Project-URL: Repository, https://github.com/jerryjliu/kinnoo
Project-URL: Issues, https://github.com/jerryjliu/kinnoo/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
Requires-Dist: PyYAML>=6.0
Requires-Dist: cryptography>=42.0
Dynamic: license-file

# Kinnoo

![Status: Beta](https://img.shields.io/badge/status-beta-blue)
![Python](https://img.shields.io/badge/python-3.10%2B-3776AB)
![License](https://img.shields.io/badge/license-MIT-green)

Kinnoo is a CLI-first platform for packaging, sharing, and installing AI agents with explicit manifest and trust controls.

It is designed for AI agent developers who need reproducible archive workflows (`.kno`), local execution, and registry-based distribution.

## Why Kinnoo

- Agent manifest contract (`kinnoo.yaml`) with validation.
- Local scaffold, run, test, inspect, pack, and install workflows.
- Registry login/publish/search/install workflows.
- Integrity and signature-aware trust flags for install and publish paths.

## Installation

```bash
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install --upgrade pip
pip install kinnoo
```

## Quick Start

```bash
kinnoo init --framework chatgpt my-agent
kinnoo run ./my-agent "hello"
kinnoo pack ./my-agent
kinnoo login
kinnoo publish ./my-agent --pack --remote
```

## Documentation

- `docs/getting-started.md`
- `docs/registry-guide.md`
- `docs/kinnoo-yaml-spec.md`
- `docs/cli-reference.md`
- `docs/security-model.md`
- `docs/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`).
