Metadata-Version: 2.4
Name: kyonis
Version: 1.0.1
Summary: Python SDK for Kyonis — Agent-native KYC/AML compliance API
Home-page: https://github.com/compliance-ai/python-sdk
Author: Compliance AI
Author-email: Kyonis SAS <sdk@kyonis.com>
License: MIT
Project-URL: Homepage, https://kyonis.com
Project-URL: Documentation, https://docs.kyonis.com
Project-URL: Repository, https://github.com/contactkyonis-droid/kyonis-mcp
Project-URL: Changelog, https://github.com/contactkyonis-droid/kyonis-mcp/blob/main/CHANGELOG.md
Keywords: kyc,aml,compliance,sanctions,regtech,fintech,screening
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.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Security
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: httpx>=0.25.0
Dynamic: author
Dynamic: home-page
Dynamic: license-file
Dynamic: requires-python

# Kyonis Python SDK

[![PyPI](https://img.shields.io/pypi/v/kyonis)](https://pypi.org/project/kyonis/)
[![Tests](https://github.com/contactkyonis-droid/kyonis-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/contactkyonis-droid/kyonis-mcp/actions)
[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](https://opensource.org/licenses/MIT)

Agent-native KYC/AML compliance API. Screen sanctions, verify identities, and run due diligence in 3 lines of Python.

## Installation

```bash
pip install kyonis
```

## Quick Start

```python
from kyonis import Client

client = Client(api_key="ky_sandbox_...")

# AML Sanctions Screening (< 500ms)
result = client.aml.screen(name="John Doe", country="US")
print(result["risk_level"])   # "clear" | "low" | "medium" | "high" | "critical"
print(result["reasoning"])    # Human-readable explanation

# KYC Verification (< 3s)
kyc = client.kyc.verify(
    nom="Dupont",
    prenom="Jean",
    date_naissance="1990-01-15",
    nationalite="FR",
)
print(kyc["risk_score"])
print(kyc["reasoning"])

# Due Diligence (< 10s)
dd = client.due_diligence.run(
    entity_name="Acme Corp",
    entity_type="company",
    country="FR",
    depth="enhanced",
)
```

## Features

| Feature | Method | Response Time |
|---------|--------|---------------|
| Sanctions Screening | `client.aml.screen()` | < 500ms |
| KYC Verification | `client.kyc.verify()` | < 3s |
| Due Diligence | `client.due_diligence.run()` | < 10s |
| UBO Resolution | `client.ubo.resolve()` | < 5s |
| Entity Risk | `client.entity.get_risk()` | < 200ms |
| GDPR Export | `client.gdpr.export()` | - |
| GDPR Erasure | `client.gdpr.erase()` | - |

## Error Handling

```python
from kyonis import Client, RateLimitError, AuthenticationError
import time

client = Client(api_key="ky_...")

try:
    result = client.aml.screen(name="Test")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Rate limited. Retry in {e.retry_after}s")
    time.sleep(e.retry_after)
```

## Links

- **Dashboard**: https://app.kyonis.com
- **Documentation**: https://docs.kyonis.com
- **GitHub**: https://github.com/contactkyonis-droid/kyonis-mcp
- **API Reference**: https://docs.kyonis.com/api-reference/overview

## License

MIT
