Metadata-Version: 2.4
Name: eqhoids
Version: 1.0.0
Summary: EqhoIDs — Python SDK for AI Agent Identity & Security Platform
Project-URL: Homepage, https://eqhoids.com
Project-URL: Documentation, https://api.eqhoids.com/docs
Project-URL: Repository, https://github.com/eqho10/eqhoids-python
Project-URL: Bug Tracker, https://github.com/eqho10/eqhoids-python/issues
Author-email: EqhoIDs <hello@eqhoids.com>
License: MIT
Keywords: agents,ai,api,identity,orchestration,security,trust,webhooks
Classifier: Development Status :: 5 - Production/Stable
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: Topic :: Security
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Requires-Python: >=3.10
Requires-Dist: httpx>=0.24.0
Description-Content-Type: text/markdown

# EqhoIDs Python SDK

Official Python client for [EqhoIDs](https://eqhoids.com) — AI Agent Identity & Security Platform.

## Install

```bash
pip install eqhoids
```

## Quick Start

```python
from eqhoids import EqhoIDs

client = EqhoIDs(api_key="eqhoai_sk_...")

# Register an agent identity (ed25519 key pair)
agent = client.trust.register_agent("my-bot", agent_type="developer")
print(agent["agent_id"], agent["public_key"])

# Sign a payload
sig = client.trust.sign(agent["agent_id"], {"action": "deploy", "target": "prod"})
print(sig["signature"])

# Verify a signature
result = client.trust.verify(agent["agent_id"], {"action": "deploy", "target": "prod"}, sig["signature"])
print(result["valid"])  # True
```

## Agent-to-Agent Trust

```python
# Register two agents
analyst = client.trust.register_agent("Atlas", agent_type="analyst")
dev = client.trust.register_agent("Dex", agent_type="developer")

# Send signed message between agents
msg = client.trust.send_message(
    from_agent_id=analyst["agent_id"],
    to_agent_id=dev["agent_id"],
    payload={"instruction": "implement auth module", "priority": "high"}
)
print(msg["verified"])  # True — signature auto-verified

# Check trust score
score = client.trust.trust_score(analyst["agent_id"])
print(score["trust_score"])  # 0.51
```

## AI Agent Tasks

```python
# Submit a task to an AI agent
task = client.agent.create_task("Analyze market trends for AI tools", agent_type="analyst")
print(task["task_id"])

# Poll for results
result = client.agent.get_task(task["task_id"])
print(result["status"])  # "completed"
print(result["result"])
```

## All Resources

| Resource | Methods |
|----------|---------|
| `client.auth` | `me()`, `quotas()`, `usage()`, `rotate_key()` |
| `client.trust` | `register_agent()`, `list_agents()`, `get_agent()`, `sign()`, `verify()`, `send_message()`, `trust_score()`, `report_task()` |
| `client.agent` | `create_task()`, `get_task()`, `cancel_task()`, `list_types()` |
| `client.memory` | `store()`, `search()` |
| `client.webhooks` | `create()`, `list()`, `get()`, `delete()`, `test()`, `deliveries()`, `events()` |
| `client.analytics` | `usage()`, `delivery_rates()`, `peak_usage()` |
| `client.audit` | `logs()`, `actions()` |
| `client.status` | `check()` |

## Links

- [API Docs](https://api.eqhoids.com/docs)
- [GitHub](https://github.com/eqho10/eqhoids-python)
