guardrails-african-pii

Guardrails AI validator for African-specific PII detection.

Generic PII validators (Presidio, spaCy NER) have no awareness of African identity formats. This validator fills that gap with pattern-based detection aligned to each country's official format specifications.

Covered entities

Regulatory alignment

• NDPA 2023 (Nigeria Data Protection Act) — §30 sensitive personal data
• KDPA 2019 (Kenya Data Protection Act) — §43 sensitive data
• POPIA (South Africa Protection of Personal Information Act) — §26
• Ghana Data Protection Act 2012
• Rwanda Law No. 058/2021 on personal data protection
• Egypt Data Protection Law No. 151/2020

Installation

guardrails hub install hub://guardrails/african_pii

Or install directly:

pip install guardrails-african-pii

Usage

from guardrails import Guard
from guardrails.hub import AfricanPii

# Detect all African PII
guard = Guard().use(AfricanPii, on_fail="exception")
guard.validate("Customer BVN: 12345678901")
# → raises ValidationError: African PII detected — BVN (NG)

# Auto-redact
guard_fix = Guard().use(AfricanPii, on_fail="fix")
result = guard_fix.validate("BVN: 12345678901 approved")
print(result.validated_output)
# → "[BVN] approved"

# Scope to specific jurisdictions
guard_ng_ke = Guard().use(
    AfricanPii,
    jurisdictions=["NG", "KE"],
    on_fail="exception"
)

# Scope to specific entity types
guard_ids = Guard().use(
    AfricanPii,
    entities=["BVN", "GHANA_CARD", "KRA_PIN"],
    on_fail="exception"
)

Parameters

When on_fail="fix", detected PII is replaced with [ENTITY_TYPE] placeholders.

Running tests

pip install guardrails-ai pytest
pytest tests/

Contributing

Part of a broader African compliance initiative. Issues and PRs welcome.

Built by Oluwajuwon Omotayo — also see:

• eve-policy — policy enforcement for AI agent tool calls
• guardrails-african-compliance — regulatory threshold and sensitive data validators