Metadata-Version: 2.4
Name: ethraeon-sdk
Version: 0.720.2
Summary: ETHRAEON SDK · constitutional runtime and evidence control layer
Home-page: https://github.com/jason-fells-research/ethraeon-canonical-app
Author: S. Jason Prohaska
Author-email: jason@ethraeon.systems
Keywords: ethraeon governance ai constitutional
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
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
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.25.0
Dynamic: author
Dynamic: author-email
Dynamic: classifier
Dynamic: description
Dynamic: description-content-type
Dynamic: home-page
Dynamic: keywords
Dynamic: requires-dist
Dynamic: requires-python
Dynamic: summary

# ETHRAEON SDK, Python

constitutional runtime and evidence control layer AND kit framework
orchestration (10-kit deployment) SDK.

Ruling 1: 16 filed / 73 specifications / 9 families.
SOC 2: self-certified (no third-party audit).

## Install

```
pip install ethraeon-sdk
```

Note: the canonical distribution name is `ethraeon-sdk` and the import
module is `ethraeon_sdk`. There is no `ethraeon` package on PyPI.

## Quick Start (LIVE against api.ethraeon.ai)

```python
from ethraeon_sdk import EthraeonClient

client = EthraeonClient()
health = client.health()
print(health["dsum"])     # 6.0
print(health["patents"])  # {"filed": 16, "specifications": 73, "families": 9}
client.close()
```

## Authenticated calls

Constitutional inference endpoints (`/v1/refine`, `/v1/vision`) require
a paid API key prefixed `ek_live_`. Provision via
[ethraeon.ai/pricing](https://ethraeon.ai/pricing/) and retrieve at
[account.ethraeon.ai](https://account.ethraeon.ai).

```python
client = EthraeonClient(api_key="ek_live_XXXXXXXX")
```

The underlying HTTP client (`client._get`, `client._post`) can call any
route documented in the [canonical OpenAPI
spec](https://ethraeon.ai/docs/api/openapi.yaml).

## API surface status

The SDK exposes namespace scaffolds (`client.governance.*`,
`client.decisions.*`, `client.risk.*`, `client.capital.*`,
`client.billing.*`, `client.models.*`, `client.policies.*`,
`client.category.*`, `client.export.*`) reserved for the forward API
surface. These namespaces are PREVIEW: they are not yet backed by live
routes on api.ethraeon.ai and calls will return HTTP 404 today.

The live surface today is:

- `GET /health` (unauthenticated), also `/v1/health` and `/__health`
- `GET /edg/{sha256}` (unauthenticated)
- `POST /v1/refine` (authenticated, `ek_live_` key)
- `POST /v1/vision` (authenticated, `ek_live_` key)
- `GET /` (Meta index)

The canonical machine-readable spec is at
[/docs/api/openapi.yaml](https://ethraeon.ai/docs/api/openapi.yaml)
(also served as [/docs/api/openapi.json](https://ethraeon.ai/docs/api/openapi.json)
since v1.1.1 of the API spec). The public changelog is at
[/docs/api/CHANGELOG.md](https://ethraeon.ai/docs/api/CHANGELOG.md).

## Governance: T5-RIGID
## Authority: AC-1 (S. Jason Prohaska), CEO ETHRAEON Systems

Humanitas Ante Machinam.
