Sovereign Agent

The executable textbook for Zero-Employee Organizations.

Sovereign Agent 1.x is a small Python reference implementation for learning how an outcome becomes governed work performed by accountable actors. Production organizations graduate to Zero Employee.

The 1.x API intentionally replaces the v0.7 fleet framework. To keep using that framework:

pip install "sovereign-agent<1"

Educational development install

Python 3.14 is required.

python -m pip install -e .
sovereign-agent doctor

Expected result:

Sovereign Agent doctor
  Python:   3.14.x OK
  Pydantic: 2.x OK
  Network:  not required
  Tokens:   not required
  Providers:
    scripted available (streaming)
    claude   missing executable
    ...
Ready for the offline curriculum. Live providers are optional.

Chapter 0 is runnable as a manually dispatched store shift (no Pulse):

sovereign-agent demo store --mode simulated

See book/ch00_first_shift and book/ch03_actor_is_not_a_model.

Product vocabulary

Thing Canonical word
Package and CLI sovereign-agent
Control loop supervisor
Installed OS hosting service
Proactive wake pulse
Intelligence CLI provider
Governed identity actor

An actor is not a model. Every provider receives the same governed assignment envelope and must emit a valid terminal event and write the exact ActorReport. A zero exit without both is a failed receipt. Cursor's --workspace is directory selection, not sandboxing; isolation belongs to Sovereign Agent's disposable workspace.

Provider subprocesses receive only base process variables plus documented credential allowlists: Claude (ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, CLAUDE_CODE_OAUTH_TOKEN), Codex (CODEX_API_KEY), and Cursor (CURSOR_API_KEY). Other parent secrets are not forwarded.

Unit 1 gates

python -m pytest -q
python scripts/verify_runtime_dependencies.py
python scripts/verify_source_budget.py
sovereign-agent --help
sovereign-agent doctor

See the educational reset ruling and v0.7 migration guide.

Project links

Data verified by PyPI on Sep 1, 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 (1.4.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for profrodai from gravatar.com profrodai

Credits

Author: Rod Rivera

GitHub Statistics

Data verified by PyPI on Sep 1, 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 expression

Apache-2.0
View SPDX License List

Requires

Python >=3.14

Tags

agents governance education zero-employee-organization

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

sovereign_agent-1.1.0.tar.gz (184.8 kB view details)

Uploaded Source

Built Distribution

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

sovereign_agent-1.1.0-py3-none-any.whl (114.5 kB view details)

Uploaded Python 3

File details

Details for the file sovereign_agent-1.1.0.tar.gz.

File metadata

  • Download URL: sovereign_agent-1.1.0.tar.gz
  • Upload date:
  • Size: 184.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for sovereign_agent-1.1.0.tar.gz
Algorithm Hash digest
SHA256 6f90173adacb9c613c5e10fff761cdc11c7fec204e043a37e484398e9c210950
MD5 0a56a85470041070fd4a0208983e5a5c
BLAKE2b-256 ca5d2ea22c88b459b38bb26dddf1b363157639bb873af8a0c687741ee94e0fc4

See more details on using hashes here.

Provenance

The following attestation bundles were made for sovereign_agent-1.1.0.tar.gz:

Publisher: publish.yml on zeroemployeeorg/sovereign-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file sovereign_agent-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: sovereign_agent-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 114.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for sovereign_agent-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 e136d0906b2affe33824fd8d6362c1ef4afa8eb18bd244bdf7e1db17b231f08e
MD5 5b7dc55c6c8fa6b30dae77a4832f0986
BLAKE2b-256 eea32c056ce95c3191b70f0c9fe1432f3d961ec692d737c763ea27c3beec0f96

See more details on using hashes here.

Provenance

The following attestation bundles were made for sovereign_agent-1.1.0-py3-none-any.whl:

Publisher: publish.yml on zeroemployeeorg/sovereign-agent

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

1.4.0

2 files

1.3.0

2 files

1.2.0

2 files

1.1.1

2 files

This release

1.1.0 This release

2 files

1.0.0

2 files

0.7.0

2 files

0.6.0

2 files

0.5.1

2 files

0.2.0

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page