Metadata-Version: 2.4
Name: pii-veil
Version: 0.0.0
Summary: Reversible PII anonymization for LLM workflows. Round-trip with persisted mapping; CLI included.
Project-URL: Homepage, https://github.com/pii-toolkit/pii-veil
Project-URL: Repository, https://github.com/pii-toolkit/pii-veil
Project-URL: Issues, https://github.com/pii-toolkit/pii-veil/issues
Author-email: Michal Piotrowski <piotrowskimichalwfis@gmail.com>
License-Expression: Apache-2.0
License-File: LICENSE
Keywords: anonymization,gdpr,llm,pii,privacy,reversible,tokenization
Classifier: Development Status :: 1 - Planning
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
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 :: Text Processing :: Linguistic
Classifier: Typing :: Typed
Requires-Python: >=3.10
Description-Content-Type: text/markdown

# pii-veil

Reversible PII anonymization for LLM workflows. Replace PII with stable tokens, send to an LLM, then deanonymize the response using the persisted mapping.

> **Pre-release placeholder.** No implementation has shipped yet. The `0.0.0` release on PyPI exists only to reserve the package name. Watch this space for the first functional release.

## Planned scope

- `Shield.anonymize(text) -> AnonymizeResult` and `Shield.deanonymize(text, mapping) -> str` — round-trip API.
- `Mapping` with stable JSON serialization for hand-off across processes.
- Strategy enum (token / mask / redact / fake), overlap resolution, deterministic token IDs.
- CLI (`pii-veil anonymize`, `pii-veil deanonymize`).
- Detector-agnostic core; depends on [`pii-core`](https://github.com/pii-toolkit/pii-core) for default detectors.

## Sibling packages

- [`pii-core`](https://github.com/pii-toolkit/pii-core) — multi-language detection primitives.
- [`pii-presidio`](https://github.com/pii-toolkit/pii-presidio) — Microsoft Presidio plugin with its own optional reversible operator.

## License

Apache-2.0. See `LICENSE`.
