agent-sovereign

Sovereign and edge deployment toolkit for self-contained agent bundles

Part of the AumOS open-source agent infrastructure portfolio.

Features

• Data sensitivity classifier assigns INFORMATIONAL, ADVISORY, or DECISION_SUPPORT risk tiers based on regulatory rules (HIPAA, GDPR, financial regulations) to determine what data may leave a sovereign boundary
• AgentPackager bundles an agent with its model weights, tools, and config into a self-contained deployment artifact targeting Docker, Kubernetes, Lambda, or bare-metal edge nodes
• EdgeRuntime validates hardware resource constraints (RAM, CPU, GPU), selects the appropriate quantization level (INT4, INT8, GGUF variants), and manages model caching for offline inference
• EdgeSync orchestrates delta synchronization of knowledge and model updates between edge nodes and a central coordinator, with offline-capable operation when network connectivity is unavailable
• Data residency policy engine enforces where data may be stored and processed, mapping sensitivity tiers to approved geographic regions
• Provenance attestation generates signed attestation records for every model inference, establishing a verifiable chain of custody from training data to deployed output
• Deployment validator checks a packaged agent against residency policies, capability declarations, and hardware constraints before authorizing a deployment

Quick Start

Install from PyPI:

pip install agent-sovereign

Verify the installation:

agent-sovereign version

Basic usage:

import agent_sovereign

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

Documentation

• Architecture
• Contributing
• Changelog
• Examples

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.