FastPII is an AI Data Security Platform with an open-source SDK for European personal identifiers. It detects, validates, and transforms sensitive data in text using checksum validation for identifiers like rodné číslo, PESEL, Steuer-ID, and SIREN.

How do I install FastPII?

Install FastPII with pip: pip install fastpii. It requires Python 3.10 or newer and has zero core dependencies.

What countries does FastPII support?

FastPII supports 4 regions: Czech Republic (15 detectors), Poland (6 detectors), Germany (6 detectors), and France (6 detectors). This includes identifiers like rodné číslo, IČO, DIČ, PESEL, NIP, REGON, Steuer-ID, USt-IdNr, SIREN, SIRET, and INSEE/NIR.

Does FastPII have external dependencies?

No. FastPII has zero core dependencies. Optional integrations like FastAPI and LangChain are available through pip extras: pip install fastpii[fastapi] or pip install fastpii[langchain].

How does FastPII validate identifiers?

FastPII uses country-specific checksum algorithms: Mod 11 for rodné číslo and IČO, Mod 10 for PESEL, ISO 7064 MOD 11,10 for Steuer-ID, Luhn for SIREN/SIRET, and Mod-97 for INSEE/NIR. This ensures only structurally valid identifiers are detected.

CLI Reference

Name: FastPII
Author: FastPII

Installation

The CLI is included with the fastpii package:

pip install fastpii

Global options

fastpii --help

Commands

detect

Detect PII in text or a file.

fastpii detect "text to analyze" [OPTIONS]

Positional arguments

Argument	Description
`text`	Text to analyze (optional if `--file` is used)

Options

Option	Short	Type	Default	Description
`--file`	`-f`	`Path`		Read text from file
`--regions`	`-r`	`list[str]`	Required	Region codes to enable (e.g., `cz pl de fr`)
`--format`	`-fmt`	`json` or `text`	`text`	Output format
`--output`	`-o`	`Path`		Write output to file

Examples

# Basic detection
fastpii detect "Jan Novák, RČ: 8001011238" -r cz

# From file
fastpii detect --file document.txt -r cz

# JSON output
fastpii detect "Email: jan.novak@example.cz" -r cz --format json

# Write to file
fastpii detect "Text with PII" -r cz -o results.json

# Multi-region
fastpii detect "PESEL: 44051401458, Steuer-ID: 86095742719" -r cz pl de fr

JSON output format

{
    "text": "Jan Novák, RČ: 8001011238",
    "findings": [
        {
            "type": "rodne_cislo",
            "value": "8001011238",
            "start": 10,
            "end": 20,
            "confidence": 1.0,
            "region": "cz",
            "metadata": {
                "checksum_valid": true,
                "birth_date": "1980-01-01",
                "gender": "male",
                "article_9": true
            }
        }
    ],
    "detector_names": ["rodne_cislo"],
    "processing_time_ms": 1
}

validate

Validate a specific identifier.

fastpii validate VALUE --detector DETECTOR_NAME [OPTIONS]

Positional arguments

Argument	Description
`value`	Value to validate

Options

Option	Short	Type	Default	Description
`--detector`	`-d`	`str`	Required	Detector name to use
`--regions`	`-r`	`list[str]`	Required	Region codes to enable
`--format`	`-fmt`	`json` or `text`	`text`	Output format

Examples

# Validate a Czech birth number
fastpii validate 8001011238 --detector rodne_cislo -r cz

# Validate a Polish PESEL
fastpii validate 44051401458 --detector pesel -r pl

# JSON output
fastpii validate 8001011238 --detector rodne_cislo -r cz --format json

Text output format

Validation Result:
  Detector: rodne_cislo
  Value: 8001011238
  Status: ✓ VALID
  Metadata:
    - checksum_valid: True
    - birth_date: 1980-01-01
    - gender: male

list-detectors

List available detectors for given regions.

fastpii list-detectors [OPTIONS]

Options

Option	Short	Type	Default	Description
`--regions`	`-r`	`list[str]`	Required	Region codes to enable
`--format`	`-fmt`	`json` or `text`	`text`	Output format

Examples

# List Czech detectors
fastpii list-detectors -r cz

# List all detectors across regions
fastpii list-detectors -r cz pl de fr

# JSON output
fastpii list-detectors -r cz --format json

evaluate

Evaluate detectors against a benchmark corpus.

fastpii evaluate --corpus PATH [OPTIONS]

Options

Option	Short	Type	Default	Description
`--corpus`		`Path`	Required	Path to corpus directory
`--output`	`-o`	`Path`	`reports`	Output directory for reports
`--regions`	`-r`	`list[str]`	`["cz"]`	Region codes to enable
`--iou-threshold`		`float`	`0.5`	IoU threshold for span matching
`--fail-on-regression`		flag	`False`	Exit with error code on regression
`--baseline`		`Path`		Path to previous baseline JSON

Examples

# Evaluate Czech detectors
fastpii evaluate --corpus tests/benchmarks/corpus --output reports -r cz

# Multi-region evaluation
fastpii evaluate --corpus tests/benchmarks/corpus -r cz pl de fr

# Custom IoU threshold
fastpii evaluate --corpus tests/benchmarks/corpus --iou-threshold 0.7 -r cz

# Fail on regression
fastpii evaluate --corpus tests/benchmarks/corpus --fail-on-regression -r cz

# Compare against baseline
fastpii evaluate --corpus tests/benchmarks/corpus --baseline reports/baseline.json -r cz

Output

============================================================
FastPII Evaluation Results
============================================================
  Corpus:     tests/benchmarks/corpus
  Samples:    50
  Words:      12000
  Precision:  84.20%
  Recall:     80.00%
  F1:         82.05%
  F2:         80.81%
  FP/1000w:   3.50
============================================================

Reports saved to reports/
Baseline saved to reports/baseline.json

CLI Reference

On this page