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 Aug 31, 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 Aug 31, 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.0.0.tar.gz (178.7 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.0.0-py3-none-any.whl (111.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: sovereign_agent-1.0.0.tar.gz
  • Upload date:
  • Size: 178.7 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.0.0.tar.gz
Algorithm Hash digest
SHA256 c3d6d967598e266e8ff4bad5c3e546a96778881917714d01699fe99169c63f12
MD5 7694fafb0879d8d388c9b01c682ffa54
BLAKE2b-256 59fdf1c4bf76772b9564d2e0aa1a5b3624d545f162f2926d938b6bb951454d2a

See more details on using hashes here.

Provenance

The following attestation bundles were made for sovereign_agent-1.0.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.0.0-py3-none-any.whl.

File metadata

  • Download URL: sovereign_agent-1.0.0-py3-none-any.whl
  • Upload date:
  • Size: 111.4 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.0.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1c76555373c9a4084f50ed9f7a94e7da867d9bc83fe35db2f88f5165adcaa705
MD5 5cf44ab0dab15a115bcb29471ed99050
BLAKE2b-256 6d3f3fec5c96a7382af7a646c581fabca0d6926057d508e4d54be7d0599042bf

See more details on using hashes here.

Provenance

The following attestation bundles were made for sovereign_agent-1.0.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

1.1.0

2 files

This release

1.0.0 This release

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