Rename project to document-pii-redactor; update all links
Browse files
README.md
CHANGED
|
@@ -1,15 +1,15 @@
|
|
| 1 |
---
|
| 2 |
license: other
|
| 3 |
license_name: per-model-licenses
|
| 4 |
-
license_link: https://huggingface.co/ekacare/pii-
|
| 5 |
tags: [pii, redaction, document-ai]
|
| 6 |
---
|
| 7 |
|
| 8 |
-
#
|
| 9 |
|
| 10 |
-
Single repo holding the models used by the
|
| 11 |
-
(https://github.com/eka-care/
|
| 12 |
-
can use the
|
| 13 |
the library, a Docker image, and a FastAPI server.
|
| 14 |
|
| 15 |
- `image/layoutlmv3/` β a text-in-image classifier for **text PII in
|
|
@@ -19,14 +19,14 @@ the library, a Docker image, and a FastAPI server.
|
|
| 19 |
- `text/minilm/` β a lightweight multilingual classifier for **PII in
|
| 20 |
plain text** (no image, no OCR).
|
| 21 |
|
| 22 |
-
**Try it live:** [ekacare/pii-redactor
|
| 23 |
β upload a document image or paste text and see detection + redaction run
|
| 24 |
in your browser.
|
| 25 |
|
| 26 |
## Install
|
| 27 |
|
| 28 |
```bash
|
| 29 |
-
pip install
|
| 30 |
```
|
| 31 |
|
| 32 |
System dependency: **Tesseract OCR** β used by the **image** modality's
|
|
@@ -50,10 +50,10 @@ first, once, and every transform consumes its output.
|
|
| 50 |
### Image β text + visual PII in document images
|
| 51 |
|
| 52 |
```python
|
| 53 |
-
from
|
| 54 |
|
| 55 |
redactor = ImagePIIRedactor(
|
| 56 |
-
"ekacare/pii-
|
| 57 |
detect_visual=True, # set False to skip visual entities (QR codes,
|
| 58 |
# face photos, signatures, etc.) β text PII only
|
| 59 |
)
|
|
@@ -77,9 +77,9 @@ deid.image.save("deidentified.png"); deid.mapping.to_dict()
|
|
| 77 |
### Text β PII in plain strings (no image, no OCR)
|
| 78 |
|
| 79 |
```python
|
| 80 |
-
from
|
| 81 |
|
| 82 |
-
r = TextPIIRedactor("ekacare/pii-
|
| 83 |
|
| 84 |
text = "John Doe, DOB 1990-01-01, john@x.com"
|
| 85 |
spans = r.detect(text) # char-offset spans β the core call
|
|
@@ -119,7 +119,7 @@ r.anonymize(text, spans)
|
|
| 119 |
Anonymization is best-effort removal/generalization of detected
|
| 120 |
identifiers β not a k-anonymity guarantee or a compliance determination.
|
| 121 |
|
| 122 |
-
See the
|
| 123 |
for the full API reference, the category taxonomy, and the Docker/FastAPI
|
| 124 |
deployment setup (the same setup behind the demo Space above).
|
| 125 |
|
|
@@ -143,17 +143,17 @@ visual detector (the `ultralytics` runtime it needs is also AGPL-3.0 and
|
|
| 143 |
is an optional `[visual]` extra of the pip package).
|
| 144 |
|
| 145 |
The library code is Apache-2.0 at
|
| 146 |
-
https://github.com/eka-care/
|
| 147 |
|
| 148 |
If you use the models or the library, please cite:
|
| 149 |
|
| 150 |
```bibtex
|
| 151 |
-
@software{
|
| 152 |
author = {{Eka Care}},
|
| 153 |
title = {Eka-PII-redaction: detect, redact, de-identify, or anonymize
|
| 154 |
PII in document images and plain text},
|
| 155 |
year = {2026},
|
| 156 |
-
url = {https://github.com/eka-care/
|
| 157 |
-
note = {Model weights: https://huggingface.co/ekacare/pii-
|
| 158 |
}
|
| 159 |
```
|
|
|
|
| 1 |
---
|
| 2 |
license: other
|
| 3 |
license_name: per-model-licenses
|
| 4 |
+
license_link: https://huggingface.co/ekacare/document-pii-redactor#license-and-attribution
|
| 5 |
tags: [pii, redaction, document-ai]
|
| 6 |
---
|
| 7 |
|
| 8 |
+
# document-pii-redactor model weights
|
| 9 |
|
| 10 |
+
Single repo holding the models used by the document-pii-redactor GitHub repo
|
| 11 |
+
(https://github.com/eka-care/document-pii-redactor), organized by modality. You
|
| 12 |
+
can use the document-pii-redactor repo directly to use these models β it has
|
| 13 |
the library, a Docker image, and a FastAPI server.
|
| 14 |
|
| 15 |
- `image/layoutlmv3/` β a text-in-image classifier for **text PII in
|
|
|
|
| 19 |
- `text/minilm/` β a lightweight multilingual classifier for **PII in
|
| 20 |
plain text** (no image, no OCR).
|
| 21 |
|
| 22 |
+
**Try it live:** [ekacare/document-pii-redactor](https://huggingface.co/spaces/ekacare/document-pii-redactor)
|
| 23 |
β upload a document image or paste text and see detection + redaction run
|
| 24 |
in your browser.
|
| 25 |
|
| 26 |
## Install
|
| 27 |
|
| 28 |
```bash
|
| 29 |
+
pip install document-pii-redactor
|
| 30 |
```
|
| 31 |
|
| 32 |
System dependency: **Tesseract OCR** β used by the **image** modality's
|
|
|
|
| 50 |
### Image β text + visual PII in document images
|
| 51 |
|
| 52 |
```python
|
| 53 |
+
from document_pii_redactor import ImagePIIRedactor
|
| 54 |
|
| 55 |
redactor = ImagePIIRedactor(
|
| 56 |
+
"ekacare/document-pii-redactor",
|
| 57 |
detect_visual=True, # set False to skip visual entities (QR codes,
|
| 58 |
# face photos, signatures, etc.) β text PII only
|
| 59 |
)
|
|
|
|
| 77 |
### Text β PII in plain strings (no image, no OCR)
|
| 78 |
|
| 79 |
```python
|
| 80 |
+
from document_pii_redactor import TextPIIRedactor
|
| 81 |
|
| 82 |
+
r = TextPIIRedactor("ekacare/document-pii-redactor")
|
| 83 |
|
| 84 |
text = "John Doe, DOB 1990-01-01, john@x.com"
|
| 85 |
spans = r.detect(text) # char-offset spans β the core call
|
|
|
|
| 119 |
Anonymization is best-effort removal/generalization of detected
|
| 120 |
identifiers β not a k-anonymity guarantee or a compliance determination.
|
| 121 |
|
| 122 |
+
See the document-pii-redactor repo (https://github.com/eka-care/document-pii-redactor)
|
| 123 |
for the full API reference, the category taxonomy, and the Docker/FastAPI
|
| 124 |
deployment setup (the same setup behind the demo Space above).
|
| 125 |
|
|
|
|
| 143 |
is an optional `[visual]` extra of the pip package).
|
| 144 |
|
| 145 |
The library code is Apache-2.0 at
|
| 146 |
+
https://github.com/eka-care/document-pii-redactor.
|
| 147 |
|
| 148 |
If you use the models or the library, please cite:
|
| 149 |
|
| 150 |
```bibtex
|
| 151 |
+
@software{document_pii_redactor,
|
| 152 |
author = {{Eka Care}},
|
| 153 |
title = {Eka-PII-redaction: detect, redact, de-identify, or anonymize
|
| 154 |
PII in document images and plain text},
|
| 155 |
year = {2026},
|
| 156 |
+
url = {https://github.com/eka-care/document-pii-redactor},
|
| 157 |
+
note = {Model weights: https://huggingface.co/ekacare/document-pii-redactor}
|
| 158 |
}
|
| 159 |
```
|