Installation¶

Python SDK (PyPI)¶

# Core (zero runtime dependencies)
pip install aegis-governance

# With scipy for utility z-score calculations
pip install aegis-governance[engine]

# With Prometheus metrics exporter
pip install aegis-governance[telemetry]

# With MCP server for AI agent integration
pip install aegis-governance[mcp]

# Full install (all optional dependencies)
pip install aegis-governance[all]

Requirements¶

Python 3.9 or later
No runtime dependencies for core functionality

Optional Dependency Groups¶

Group	Purpose	Key Packages
`engine`	Utility z-score computation	scipy
`telemetry`	Prometheus metrics exporter	prometheus_client
`config`	YAML configuration loading	pyyaml
`mcp`	MCP server support	pyyaml
`crypto`	BIP-340 Schnorr signatures	btclib, coincurve
`pqc`	Post-quantum (ML-DSA, ML-KEM)	liboqs-python
`persistence`	Workflow state storage	sqlalchemy, asyncpg

REST API¶

No installation needed — call the hosted API directly:

curl https://YOUR_API_URL/health

See the REST API Quickstart for details.

CLI¶

The CLI is included with the Python package:

pip install aegis-governance
aegis version

From Source¶

git clone https://github.com/undercurrentai/aegis-governance.git
cd aegis-governance
pip install -e ".[dev]"
pytest tests/ -v --tb=short  # Verify installation

Verify Installation¶

from aegis_governance import __version__, pcw_decide
print(f"AEGIS {__version__} installed successfully")

aegis version