Metadata-Version: 2.4
Name: zeno-core
Version: 1.0.2
Summary: Zeno core runtime: Ctx, agents, tools, turn worker, streaming, tracer.
Project-URL: Homepage, https://github.com/nkootstra/zeno
Project-URL: Repository, https://github.com/nkootstra/zeno
Project-URL: Issues, https://github.com/nkootstra/zeno/issues
Project-URL: Changelog, https://github.com/nkootstra/zeno/blob/main/CHANGELOG.md
Author: Niels Kootstra
License-Expression: MIT
License-File: LICENSE
Keywords: agent,ai,async,claude,framework,llm
Classifier: Development Status :: 5 - Production/Stable
Classifier: Framework :: AsyncIO
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Libraries
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: httpx<1,>=0.27
Requires-Dist: python-dotenv>=1.0
Requires-Dist: structlog>=24.1
Description-Content-Type: text/markdown

# zeno-core

Core runtime for the [Zeno](https://github.com/nkootstra/zeno) framework.

## Install

```bash
uv add zeno-framework
```

Public surface:

- `Ctx`, ContextVar plumbing, `@tool` decorator, `Agent` / `SubAgent`.
- `ZenoApp` — binds channels, agent, memory, provider, tracer.
- `Provider` protocol + `Capabilities` dataclass + `ProviderCapabilityError`.
- `Channel` protocol, turn worker, streaming, tracer, failure policies.
- `MemoryBinderProtocol`, `SecretsStore`, and other extension protocols.
- Plugin entry-point discovery (`zeno.sub_agents`, `zeno.providers`,
  `zeno.tools`, `zeno.channels`, `zeno.vectorstores`).

Concrete `Provider` adapters live in sibling packages:
[`zeno-provider-claude`](https://github.com/nkootstra/zeno/tree/main/packages/zeno-provider-claude)
and
[`zeno-provider-openai`](https://github.com/nkootstra/zeno/tree/main/packages/zeno-provider-openai).

Part of a lockstep `1.x` release. Install via the `zeno-framework` meta-package:

```bash
uv add 'zeno-framework[cli]'          # Claude Agent SDK backend (default)
uv add 'zeno-framework[openai,cli]'   # OpenAI-compatible backend
```

Part of the [Zeno framework](https://github.com/nkootstra/zeno).
