Metadata-Version: 2.4
Name: identity-os-sdk
Version: 0.9.0
Summary: Python SDK for Identity OS — Stateful Personality Engine for AI Agents
Author: Identity OS Contributors
License: MIT
Project-URL: Homepage, https://xiocasso.github.io/identityOs/
Project-URL: Repository, https://github.com/Xiocasso/identityOs
Project-URL: Documentation, https://xiocasso.github.io/identity-os-docs/sdks/python/
Keywords: identity-os,ai-agent,personality,behavioral-runtime,sdk
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Requires-Python: >=3.10
Description-Content-Type: text/markdown
Requires-Dist: httpx>=0.27.0
Requires-Dist: pydantic>=2.0
Provides-Extra: dev
Requires-Dist: pytest>=7.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.23; extra == "dev"
Requires-Dist: respx>=0.21; extra == "dev"

# Identity OS Python SDK

Runtime behavioral control for AI agents.

## Install

```bash
pip install identity-os-sdk
```

## Quick Start

```python
from identity_os_sdk import IdentityOS, Mode

client = IdentityOS(api_key="idos_sk_xxx")

# Create agent instance
instance = client.instances.create(name="Aria")

# Process observation → get ExecutionContract
result = client.engine.process(
    instance_id=instance.id,
    mode_target=Mode.EXPLORATION,
    signal_strength=0.7
)

# Contract tells your agent what it can do
print(result.contract.allowed_actions)
print(result.contract.forbidden_actions)
```

## Links

- [Documentation](https://docs.identity-os.dev)
- [API Reference](https://docs.identity-os.dev/api/)
- [Quick Start Guide](https://docs.identity-os.dev/quickstart/)
- [Website](https://identity-os.dev)
