Metadata-Version: 2.5
Name: aira-sdk
Version: 3.10.1
Summary: Personal experiment: cryptographic signing and policy evaluation for AI agent actions
Project-URL: Homepage, https://airaproof.com
Project-URL: Documentation, https://docs.airaproof.com
Project-URL: Repository, https://github.com/aira-proof/python-sdk
Project-URL: Issues, https://github.com/aira-proof/python-sdk/issues
Author-email: Aira <sdk@airaproof.com>
License-Expression: MIT
License-File: LICENSE
Keywords: agents,ai,aira,compliance,eu-ai-act,notarization
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Security :: Cryptography
Requires-Python: >=3.10
Requires-Dist: httpx>=0.27
Provides-Extra: all
Requires-Dist: boto3>=1.34; extra == 'all'
Requires-Dist: claude-agent-sdk<2.0,>=0.2; extra == 'all'
Requires-Dist: crewai<2.0,>=0.80; extra == 'all'
Requires-Dist: google-adk<3.0,>=0.1; extra == 'all'
Requires-Dist: langchain-core<2.0,>=0.3; extra == 'all'
Requires-Dist: mcp<2.0,>=1.30.0; extra == 'all'
Requires-Dist: openai>=3.0; extra == 'all'
Requires-Dist: rich>=13.0; extra == 'all'
Requires-Dist: typer>=0.12; extra == 'all'
Provides-Extra: bedrock
Requires-Dist: boto3>=1.34; extra == 'bedrock'
Provides-Extra: claude-agent
Requires-Dist: claude-agent-sdk<2.0,>=0.2; extra == 'claude-agent'
Provides-Extra: cli
Requires-Dist: rich>=13.0; extra == 'cli'
Requires-Dist: typer>=0.12; extra == 'cli'
Provides-Extra: crewai
Requires-Dist: crewai<2.0,>=0.80; extra == 'crewai'
Provides-Extra: google-adk
Requires-Dist: google-adk<3.0,>=0.1; extra == 'google-adk'
Provides-Extra: langchain
Requires-Dist: langchain-core<2.0,>=0.3; extra == 'langchain'
Provides-Extra: mcp
Requires-Dist: mcp<2.0,>=1.30.0; extra == 'mcp'
Provides-Extra: openai-agents
Requires-Dist: openai>=3.0; extra == 'openai-agents'
Provides-Extra: webhooks
Description-Content-Type: text/markdown

# Aira Python SDK

[![PyPI](https://img.shields.io/pypi/v/aira-sdk)](https://pypi.org/project/aira-sdk/)
[![License](https://img.shields.io/pypi/l/aira-sdk)](LICENSE)
[![Python](https://img.shields.io/pypi/pyversions/aira-sdk)](https://pypi.org/project/aira-sdk/)

Personal experiment exploring cryptographic signing and policy evaluation for AI agent actions. Built as a learning project to understand Ed25519 signatures, RFC 3161 timestamps, and policy engines.

> **Status:** This is a personal hobby project, not a commercial product. Use at your own risk.

## Installation

```bash
pip install aira-sdk
```

Requires Python 3.10+.

## Quick start

```python
from aira import Aira

aira = Aira(api_key="aira_live_xxx")

# Authorize an action against policies
auth = aira.authorize(
    action_type="wire_transfer",
    details="Send EUR 75,000 to vendor-x",
    agent_id="payments-agent",
    model_id="claude-sonnet-4-6",
)

# Sign the outcome with Ed25519
receipt = aira.notarize(
    action_id=auth.action_id,
    outcome="completed",
    outcome_details="Wire sent",
)
```

## Async support

```python
from aira import AsyncAira

async with AsyncAira(api_key="aira_live_xxx") as aira:
    auth = await aira.authorize(
        action_type="contract_signed",
        details="Signed vendor agreement #1234",
        agent_id="procurement-agent",
    )
```

## Framework integrations

| Integration | Install |
|---|---|
| **LangChain** | `pip install aira-sdk[langchain]` |
| **OpenAI Agents** | `pip install aira-sdk[openai-agents]` |
| **Google ADK** | `pip install aira-sdk[google-adk]` |
| **AWS Bedrock** | `pip install aira-sdk[bedrock]` |
| **CrewAI** | `pip install aira-sdk[crewai]` |
| **MCP** | `pip install aira-sdk[mcp]` |

## Self-hosted

```python
aira = Aira(api_key="aira_live_xxx", base_url="https://your-instance.example.com")
```

## License

MIT
