αύρα — AURA Harness

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


Version License Python Version Status 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 (GitHub Cite this repository).
  • 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.0.tar.gz (33.1 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.0-py3-none-any.whl (38.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: aura_harness-0.3.0.tar.gz
  • Upload date:
  • Size: 33.1 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.0.tar.gz
Algorithm Hash digest
SHA256 02a6e4a681af163d3ba1d198bef34b2443ea4204b4fd10d90e46f40bda68804e
MD5 22ca27297b3641eebd8d304f59466185
BLAKE2b-256 b9fca32ad50ab10b4bd5b57c2e6425bfb5ca4f22ed28ae090634a17b870c0462

See more details on using hashes here.

Provenance

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

File metadata

  • Download URL: aura_harness-0.3.0-py3-none-any.whl
  • Upload date:
  • Size: 38.4 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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 fae9b9520067f665d7cd45d5328bb619984f589bb4e9f010c540bb8706ac6926
MD5 5cb5d35986ce6dc6083dc5193fb6ccd2
BLAKE2b-256 a30726529e5aa263515297aa718e49c855bbfa3a8cefb74beb20c3adf5753ceb

See more details on using hashes here.

Provenance

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