Metadata-Version: 2.4
Name: aglet
Version: 0.1.0a4
Summary: Aglet core: protocols, runtime, event bus, plugin loader.
Project-URL: Homepage, https://github.com/zyssyz123/agentkit
Project-URL: Repository, https://github.com/zyssyz123/agentkit
Project-URL: Issues, https://github.com/zyssyz123/agentkit/issues
Author: The Aglet Contributors
License-Expression: Apache-2.0
Keywords: agent,framework,llm,plugin
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.11
Requires-Dist: anyio>=4.3
Requires-Dist: httpx<1.0,>=0.27
Requires-Dist: pydantic>=2.6
Requires-Dist: pyyaml>=6.0
Description-Content-Type: text/markdown

# aglet

> The pluggable Agent runtime: protocols, runtime, event bus, plugin loader.

`aglet` is the core of [the Aglet project](https://github.com/zyssyz123/agentkit) — a
framework where every Agent capability is a swappable plugin distributed as its own
PyPI package.

## What's inside

* The 9 first-class **Element** protocols (perception / memory / planner / tool /
  executor / safety / output / observability / extensibility) plus the
  `ModelProvider` plugin point.
* An immutable `AgentContext` + `ContextPatch` event-sourcing model.
* The default canonical Loop (`Runtime.run` / `Runtime.resume`) with built-in
  Hook system, Budget enforcement, three routing strategies, and four plugin
  runtimes (in-process, subprocess, HTTP, MCP).
* A YAML config loader and a `Registry` that auto-discovers third-party
  Techniques via Python entry points (`aglet.techniques`, `aglet.models`,
  `aglet.elements`).

## Install

`aglet` alone is enough to **build** an agent in Python; install built-in
Techniques separately to actually **run** something useful.

```bash
pip install aglet                                          # core only
pip install aglet-cli aglet-builtin-planner-echo \
            aglet-builtin-perception-passthrough \
            aglet-builtin-output-streaming-text \
            aglet-builtin-memory-sliding-window \
            aglet-builtin-obs-console                      # smallest runnable agent
```

Then:

```bash
aglet init my-agent && cd my-agent
aglet run agent.yaml --input "hello"
```

## Status

Alpha (`0.1.0a1`) — the protocols are still subject to backwards-incompatible
change before `1.0`. Interfaces are documented in the
[architecture doc](https://github.com/zyssyz123/agentkit/blob/main/docs/architecture.md).

## License

Apache-2.0
