Metadata-Version: 2.4
Name: zimam
Version: 0.0.1
Summary: Earned-autonomy governance for AI agents. Ships the shared protocol vocabulary today; the full Python SDK arrives in 2027.
Project-URL: Homepage, https://zimam.dev
Project-URL: Source, https://github.com/zimamhq/zimam-py
Project-URL: Issues, https://github.com/zimamhq/zimam-py/issues
Author-email: Zimam <oss@zimam.dev>
License-Expression: AGPL-3.0-only
License-File: LICENSE
Keywords: agents,ai,autonomy,governance,policy,receipts,trust
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# zimam

Earned-autonomy governance for AI agents — the Python package.

Zimam (Arabic: زمام, *"reins"*) is an open-source governance layer in which
AI agents earn autonomy the way employees earn trust: actions are classified
by blast radius, judged against per-class trust levels (L0–L3), and every
decision produces a signed, verifiable receipt. The reference runtime lives
at [zimamhq/zimam](https://github.com/zimamhq/zimam).

**Status:** this package ships the shared vocabulary of the Zimam protocol —
action classes and trust levels — so Python code can already speak the same
language as the runtime. The full Python SDK (policy evaluation, trust
accounting, receipt verification) is planned for 2027 and will land here.

## Install

```bash
pip install zimam
```

## Usage

```python
import zimam

zimam.ACTION_CLASSES          # ("READ", "WRITE_INTERNAL", "COMM_EXTERNAL", "FINANCIAL", "DESTRUCTIVE")
zimam.TRUST_LEVELS            # ("L0", "L1", "L2", "L3")
zimam.is_action_class("FINANCIAL")   # True
zimam.is_action_class("YOLO")        # False
```

## License

[AGPL-3.0-only](LICENSE)
