αύρα — AURA Harness

AURA Harness - A runtime coat for agent loops — audit, policy, and compliance export.


Version DOI License ARPA HLS

Overview · How it works · Architecture · Quick start · Documentation

Overview

AURA Harness wraps whatever runs your agent loop — a Python script, Skillware, LangGraph, or your own host. It does not replace the loop. It sits around it, records what happened, enforces your rules at tool boundaries, and exports a session you can ship to logs or compliance.
For Teams that need provenance, policy, and repeatable pipelines around agents
Not A model runtime, orchestrator, or skill framework
Pairs with Skillware (tools), any LLM host, your existing loop

How it works

flowchart LR
    Host[Host] --> Aura[AURA]
    Aura --> Audit[Audit Trail]

Your host runs the loop. AURA attaches — policy at egress, causal logging. On close, the audit trail becomes session export (JSONL, summary, audit report).

→ using-aura.md · skillware-integration.md

Architecture

Optional inputs feed the body; AURA wraps it; audit and export follow.

flowchart LR
    ID["Identity"] -.-> BODY["Body / Runtime"]
    BRAIN["Brain"] -.-> BODY
    MEM["Memory"] -.-> BODY
    TOOLS["Tools"] -.-> BODY
    CONST["Constitution"] -.-> BODY

    BODY --> AURA["AURA Harness"]
    AURA --> TRAIL["Audit Trail"]
    TRAIL --> EXPORT["Session Export"]
    TRAIL -.-> OBS["Observers"]

→ architecture.md · stack-position.md

Quick start

Requires Python 3.10+.

Install from PyPI:

pip install aura-harness
# optional Skillware host extra:
pip install "aura-harness[skillware]"

Develop from source:

git clone https://github.com/ARPAHLS/aura.git
cd aura
py -3.13 -m venv .venv && .venv\Scripts\activate   # Windows
pip install -e ".[dev]"
pytest

from aura import agent, configure

configure()

ag = agent("acme/research-bot", policy_version="1")
with ag.session() as run:
    run.emit("turn.start", {"input": "hello"})
    run.emit("turn.end", {"tokens": 120})

print(run.exports)

CLI: aura agent create, aura run, aura export, aura compare, aura export-otel.

→ getting-started.md · examples/

Documentation

Topic Links
Start getting-started.md · concepts.md · using-aura.md
Integration skillware-integration.md · sequencer.md
Identity & audit trust-paths.md · outputs.md
Compare & position comparison.md · ROADMAP.md
Contribute CONTRIBUTING.md · Agent workflow · TESTING.md · PUBLISHING.md · CHANGELOG.md

Notes

  • Experimental (alpha) — API may change between minor releases until 1.0.
  • Wrap, don't replace — your host owns the loop; AURA records and gates at boundaries you wire through emit() or SkillwareHost.
  • Security — loaded skills and scripts run in your process; see SECURITY.md.
  • Citation — CITATION.cff · DOI 10.5281/zenodo.22031863 (Zenodo concept DOI)
  • Support — issues · systems@arpacorp.net

ARPA Logo
Developed and Maintained by ARPA HELLENIC LOGICAL SYSTEMS
Support: systems@arpacorp.net

Project links

Data verified by PyPI on Aug 20, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Latest release

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for rosspeili from gravatar.com rosspeili

Credits

Author: ARPA Hellenic Logical Systems

GitHub Statistics

Data verified by PyPI on Aug 20, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License

MIT License (MIT)

Requires

Python >=3.10

Provides Extra

dev skillware

Tags

agents agent-harness ai-agents audit-trail aura compliance conformance governance observability policy runtime sidecar

Classifiers

Report project as malware

Download files

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

Source Distribution

aura_harness-0.3.2.tar.gz (33.2 kB view details)

Uploaded Source

Built Distribution

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

aura_harness-0.3.2-py3-none-any.whl (38.5 kB view details)

Uploaded Python 3

File details

Details for the file aura_harness-0.3.2.tar.gz.

File metadata

  • Download URL: aura_harness-0.3.2.tar.gz
  • Upload date:
  • Size: 33.2 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aura_harness-0.3.2.tar.gz
Algorithm Hash digest
SHA256 3aad96f5d31d2f247ecfa5facec3ebdca4e5cc5856503e572002b0e42a0a02bd
MD5 5e59c1307e724976416f05c71f3e1f32
BLAKE2b-256 8312bd402f02c0b1b493ae8e25ffcded293684c4530add591881d2bf9337d51b

See more details on using hashes here.

Provenance

The following attestation bundles were made for aura_harness-0.3.2.tar.gz:

Publisher: publish-pypi.yml on ARPAHLS/aura

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file aura_harness-0.3.2-py3-none-any.whl.

File metadata

  • Download URL: aura_harness-0.3.2-py3-none-any.whl
  • Upload date:
  • Size: 38.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for aura_harness-0.3.2-py3-none-any.whl
Algorithm Hash digest
SHA256 0b010c675f20be20fbf901903469fdcd2ccbd551a677216b6c5756b4f6df5cb3
MD5 bfdcb95c760a18aab486a5e42aabc9e6
BLAKE2b-256 40aaf5a2939dd9e8956bdd700cc693492c6d18bf7d0be557afb8ba8a8bb949ba

See more details on using hashes here.

Provenance

The following attestation bundles were made for aura_harness-0.3.2-py3-none-any.whl:

Publisher: publish-pypi.yml on ARPAHLS/aura

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

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