Metadata-Version: 2.4
Name: ameva-sentinel
Version: 2.1.0
Summary: Shadow-First Automation Risk Observation & Multi-Axis Threat Telemetry Layer for Python (FastAPI, Flask, Django)
Author-email: AMEVA Foundation <zhfldk014745@naver.com>
License: Apache-2.0
Project-URL: Homepage, https://uno-km.vercel.app/sentinel/
Project-URL: Documentation, https://uno-km.vercel.app/lib/sentinel/
Project-URL: Repository, https://github.com/uno-km/ameva-sentinel
Project-URL: Issues, https://github.com/uno-km/ameva-sentinel/issues
Keywords: security,bot-detection,threat-telemetry,cloudflare-workers,fastapi,flask,privacy-first
Classifier: Development Status :: 5 - Production/Stable
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.8
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 :: Security
Classifier: Topic :: Internet :: WWW/HTTP :: HTTP Servers
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Provides-Extra: fastapi
Requires-Dist: fastapi>=0.68.0; extra == "fastapi"
Requires-Dist: starlette>=0.14.0; extra == "fastapi"
Provides-Extra: flask
Requires-Dist: flask>=2.0.0; extra == "flask"
Provides-Extra: all
Requires-Dist: fastapi>=0.68.0; extra == "all"
Requires-Dist: starlette>=0.14.0; extra == "all"
Requires-Dist: flask>=2.0.0; extra == "all"
Provides-Extra: test
Requires-Dist: pytest>=7.0.0; extra == "test"

# AMEVA-Sentinel (Python SDK)

> **Shadow-First Automation Risk Observation & Multi-Axis Threat Telemetry Layer for Python Web Applications**  
> *Official Python SDK for FastAPI, Starlette, Flask, and Django with Edge Provider Adapters & Privacy-by-Design.*

[![PyPI version](https://img.shields.io/pypi/v/ameva-sentinel.svg?color=blue)](https://pypi.org/project/ameva-sentinel/)
[![Python versions](https://img.shields.io/pypi/pyversions/ameva-sentinel.svg)](https://pypi.org/project/ameva-sentinel/)
[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
[![Official Docs](https://img.shields.io/badge/docs-uno--km.vercel.app%2Fsentinel-004499)](https://uno-km.vercel.app/lib/sentinel/)

---

## ⚡ Quick Start

### 1. Installation
```bash
pip install ameva-sentinel
```

### 2. Direct Evaluation
```python
from ameva_sentinel import Sentinel

sentinel = Sentinel(mode="shadow")
headers = {
    "user-agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) Chrome/124.0",
    "cf-ray": "8f123-ICN",
    "cf-connecting-ip": "203.0.113.195"
}
assessment = sentinel.evaluate(headers=headers, signals={"screen_hz": 60})
print(assessment.to_dict())
```
