parmana 1.0.4

Official Python SDK for the Parmana Execution Trust Infrastructure.

# Parmana

**Proof of Human Authority in AI Systems**

[](https://pypi.org/project/parmana/)

[](https://pypi.org/project/parmana/)

[](https://github.com/pavancharak/parmana/blob/main/LICENSE)

The official Python SDK for the **Parmana Execution Trust Infrastructure**.

Parmana enables organizations to confidently deploy AI in high-impact workflows by ensuring that **only authorized actions are executed** and every execution is accompanied by verifiable execution evidence.

---

## Why Parmana?

Modern AI systems can plan, reason, call tools, and execute workflows.

What they usually cannot prove is:

- Who authorized an execution?

- Which policy approved it?

- Was the execution verified?

- Can it be independently replayed?

- Is there cryptographic evidence of what occurred?

Parmana provides the execution trust layer that answers those questions.

---

## Installation

pip install parmana

Requirements:

- Python 3.10+

- Parmana Runtime

---

## Quick Start

from parmana import ParmanaClient



client = ParmanaClient(

    endpoint="http://localhost:3000",

)



print(client.version)

---

## Execute a Business Transaction

from parmana.models import BusinessTransaction



transaction = BusinessTransaction(

    business\_transaction\_id="txn-001",

)



trust\_record = client.execute(transaction)



print(trust\_record.trust\_record\_id)

---

## Verify

verification = client.verify("txn-001")



print(verification.status)

---

## Replay

result = client.replay("txn-001")



print(result.success)

---

## Execution Lifecycle

Business Transaction

        |

        v

Execution

        |

        v

Verification

        |

        v

Receipt

        |

        v

Execution Trust Record

---

## Python SDK

The SDK includes:

| Method | Description |

|--------|-------------|

| health() | Runtime health |

| execute() | Execute a Business Transaction |

| verify() | Verify an execution |

| replay() | Replay a previous execution |

| receipt() | Generate an execution receipt |

| transaction() | Retrieve a Business Transaction |

| trust\_record() | Retrieve an Execution Trust Record |

| validate\_policy() | Validate a policy |

---

## Documentation

- Documentation: https://docs.parmana.ai

- GitHub: https://github.com/pavancharak/parmana

- Issues: https://github.com/pavancharak/parmana/issues

---

## License

Apache License 2.0