Metadata-Version: 2.4
Name: admina-core
Version: 0.9.0
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: POSIX :: Linux
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Rust
Classifier: Topic :: Security
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Python Modules
Summary: Admina governance engines — Rust core with Python bindings (firewall, PII, loop breaker, hash chain)
Keywords: ai,governance,compliance,eu-ai-act,pii,llm,agent-security,injection-firewall,rust,pyo3
Author-email: Stefano Noferi <info@admina.org>
Maintainer-email: Stefano Noferi <info@admina.org>
License-Expression: Apache-2.0
Requires-Python: >=3.11
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM
Project-URL: Changelog, https://github.com/admina-org/admina/blob/main/CHANGELOG.md
Project-URL: Documentation, https://github.com/admina-org/admina#readme
Project-URL: Homepage, https://admina.org
Project-URL: Issues, https://github.com/admina-org/admina/issues
Project-URL: Repository, https://github.com/admina-org/admina
Project-URL: Security, https://github.com/admina-org/admina/blob/main/SECURITY.md

# admina-core

Rust accelerator for the [Admina](https://github.com/admina-org/admina)
AI governance framework. Implements the performance-critical paths of
the four governance domains in Rust, exposed to Python via PyO3:

- **Injection firewall** — regex set + heuristic scorer
- **PII scanner** — regex + checksum validators (EU national IDs)
- **Loop breaker** — TF-IDF cosine similarity over a sliding window
- **Forensic hash chain** — SHA-256 append-only log with chain integrity

## Installation

```bash
pip install admina-core
```

The Python framework auto-detects the Rust engine at runtime and falls
back to a pure-Python implementation if `admina-core` is not installed,
so `admina-framework` always works on its own.

## License

Apache-2.0. See the
[main repository](https://github.com/admina-org/admina) for full
documentation, the model card, and the governance domain modules.

