Metadata-Version: 2.4
Name: konen
Version: 0.1.0
Summary: Human-centered star-graph orchestration of AI agents
Author: Theodore Papamarkou
License-Expression: MIT
License-File: LICENSE
Requires-Dist: anthropic
Requires-Dist: google-genai>=2.18.1,<3.0.0
Requires-Dist: jsonschema
Requires-Dist: kimi-sdk
Requires-Dist: openai
Requires-Dist: prompt-toolkit
Requires-Dist: rich
Requires-Python: >=3.13, <3.16
Project-URL: Source, https://github.com/polyshape/konen
Project-URL: Documentation, https://polyshape.github.io/konen/
Description-Content-Type: text/markdown

<p align="center">
  <img src="https://raw.githubusercontent.com/polyshape/konen/main/logo/konen_logo_transparent_bg.svg" alt="Konen logo" width="120">
</p>

# Konen: human-centered orchestration of AI agents

*The Swiss army knife for agentic IREs*

Konen is pronounced /ˈkoʊnɛn/. Its name comes from the star graph $K_{1,n}$, reflecting Konen's human-centered approach to agentic interaction. The human occupies the central node and orchestrates a collection of AI agents represented by the leaf nodes.

Konen emphasizes human-directed deliberation. A user decides which agents participate and how they engage with each other's contributions, while maintaining a shared conversation history. Although similar capabilities exist in other multi-model tools, Konen offers a simple, focused approach suited to iterative exploration of ideas, critical analysis, and research. Thus, Konen is suited to use as an integrated research environment (IRE) for coordinating interactions across AI agents and model providers.

## Installation

Konen requires Python 3.13, 3.14, or 3.15.

### pip

Install Konen from PyPI:

```bash
pip install konen
```

### uv

To install the CLI in an isolated environment:

```bash
uv tool install konen
```

Run `konen` after installing it. For a source checkout and development setup, see [DEVELOPMENT.md](https://github.com/polyshape/konen/blob/main/DEVELOPMENT.md).

## Documentation

Read the [documentation](https://polyshape.github.io/konen/), starting with the [first walkthrough example](https://polyshape.github.io/konen/examples/ai-consciousness-evidence.html).

## License

Konen is distributed under the MIT License. See [LICENSE](https://github.com/polyshape/konen/blob/main/LICENSE).
