Skip to main content

AI agent governance and compliance engine with policy enforcement

Project description

agent-gov

AI agent governance and compliance engine with policy enforcement

CI PyPI version Python versions License

Part of the AumOS open-source agent infrastructure portfolio.


Features

  • Declarative YAML policy schema (PolicyConfig) with versioned rules, per-rule severity, enable/disable flags, and arbitrary metadata for audit trails
  • PolicyEngine evaluates action contexts against ordered rule lists using AND/OR condition logic with operators including contains_pii, matches, greater_than, and in_list
  • Four built-in rule types — PII check, role check, cost limit, and keyword block — each implementing the PolicyRule ABC and registered via the plugin system
  • Compliance framework stubs for EU AI Act, GDPR, HIPAA, and SOC 2 that map rule violations to specific regulatory articles and controls
  • Append-only audit logger with structured JSON entries and a search API for querying the audit trail by agent ID, policy name, and time range
  • Compliance report generator producing JSON and Markdown summaries grouped by framework and severity
  • agentcore bridge that hooks PolicyEngine evaluation into the EventBus lifecycle so governance runs transparently alongside agent execution

Quick Start

Install from PyPI:

pip install agent-gov

Verify the installation:

agent-gov version

Basic usage:

import agent_gov

# See examples/01_quickstart.py for a working example

Documentation

Enterprise Upgrade

For production deployments requiring SLA-backed support and advanced integrations, contact the maintainers or see the commercial extensions documentation.

Contributing

Contributions are welcome. Please read CONTRIBUTING.md before opening a pull request.

License

Apache 2.0 — see LICENSE for full terms.


Part of AumOS — open-source agent infrastructure.

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

agent_gov-0.2.0.tar.gz (151.1 kB view details)

Uploaded Source

Built Distribution

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

agent_gov-0.2.0-py3-none-any.whl (125.2 kB view details)

Uploaded Python 3

File details

Details for the file agent_gov-0.2.0.tar.gz.

File metadata

  • Download URL: agent_gov-0.2.0.tar.gz
  • Upload date:
  • Size: 151.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for agent_gov-0.2.0.tar.gz
Algorithm Hash digest
SHA256 ba8441735fe0ae3f9c6c690cbbba43a07683093afb1a59e9c55161cdb66311aa
MD5 92bdc9ef280743902fab172d9726104f
BLAKE2b-256 d3314b03c75b136763bf2d68cd0c98e4fc20ecae4423a76ee14259789fe42143

See more details on using hashes here.

File details

Details for the file agent_gov-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: agent_gov-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 125.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.11.9

File hashes

Hashes for agent_gov-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4112e83aeb07d2ef503c8e8fb8c3175c14bbbdba1d780f650077e9bc2f58df44
MD5 16bfe6b4687e6fc48636451bb29da35d
BLAKE2b-256 2a3f31bbbf0fe47e850a8cf32445bfb91b507722a9bc27a9f5b42a9664c1e725

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