Skip to main content

Aglet core: protocols, runtime, event bus, plugin loader.

Project description

aglet

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

aglet is the core of the Aglet project — 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.

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:

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.

License

Apache-2.0

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

aglet-0.1.0a3.tar.gz (34.4 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

aglet-0.1.0a3-py3-none-any.whl (49.7 kB view details)

Uploaded Python 3

File details

Details for the file aglet-0.1.0a3.tar.gz.

File metadata

  • Download URL: aglet-0.1.0a3.tar.gz
  • Upload date:
  • Size: 34.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for aglet-0.1.0a3.tar.gz
Algorithm Hash digest
SHA256 eb47494939191eb51e55f5656e7a48a87fd4c48a7e42b1dfc3c5e94dbf10df05
MD5 ce15dfe3b843233356f24ef431e39415
BLAKE2b-256 1d24adddb7f2d6cc2584446d8c631432893d7d453f7cdb4954ba68bd528739cc

See more details on using hashes here.

File details

Details for the file aglet-0.1.0a3-py3-none-any.whl.

File metadata

  • Download URL: aglet-0.1.0a3-py3-none-any.whl
  • Upload date:
  • Size: 49.7 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.4

File hashes

Hashes for aglet-0.1.0a3-py3-none-any.whl
Algorithm Hash digest
SHA256 90e472e4cd8a0883a39b062e629637ff4b935b7b8aca8762fa25a527d75c9485
MD5 7e110ae44f44bf878fa3a870dc1a1906
BLAKE2b-256 26b2a74f4cd3500173b3b001aea71318f61d7ce8daa39b671328fa8cf528bdf1

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page