αύρα — AURA Harness

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


Version DOI Status
License Python Version 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:
Newer release available (0.3.2)

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.1.tar.gz (33.3 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.1-py3-none-any.whl (38.5 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aura_harness-0.3.1.tar.gz
  • Upload date:
  • Size: 33.3 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.1.tar.gz
Algorithm Hash digest
SHA256 533e7b7a71e7745beb2dd4fbd8501067eb8da5ce40d90303aa764fbf4e8e5bd1
MD5 1f7b3a2df1b3f6b6b4b68b6b59800995
BLAKE2b-256 bfcd33ccbeecb9cff23791fed81c7dab60eff1359cf65efa71a4349ee76caf51

See more details on using hashes here.

Provenance

The following attestation bundles were made for aura_harness-0.3.1.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.1-py3-none-any.whl.

File metadata

  • Download URL: aura_harness-0.3.1-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.1-py3-none-any.whl
Algorithm Hash digest
SHA256 295e748743c695f3f7ebddbfa6d61314e985a9baabf473adf82200c4b7a4d7fb
MD5 e5434bb4d52e81f3eef389bb940e5914
BLAKE2b-256 ce5972edb14a6c01dbfcde33e1c021d50571a7335aa3a943b9fac628e88abd80

See more details on using hashes here.

Provenance

The following attestation bundles were made for aura_harness-0.3.1-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