guardrails-african-compliance

Guardrails AI validator for African financial and data protection compliance.

Validates LLM outputs against African regulatory frameworks — detecting special-category data, AML/CFT transaction thresholds, and prohibited cross-border data transfers.

What it checks

1. Sensitive data (sensitive_data)

Flags special-category data keywords under African data protection laws:

2. CBN transaction thresholds (cbn_threshold)

Flags Nigerian Naira (NGN / ₦) amounts in LLM output:

3. CBK transaction thresholds (cbk_threshold)

Flags Kenyan Shilling (KES / KSh) amounts:

4. Cross-border data transfers (cross_border)

Flags data transfer language directed at countries without NDPA 2023 §43 adequacy determination (China, Russia, Iran, North Korea, Belarus, Myanmar, Cuba, Syria).

Installation

guardrails hub install hub://guardrails/african_compliance

Or install directly:

pip install guardrails-african-compliance

Usage

from guardrails import Guard
from guardrails.hub import AfricanCompliance

# Run all checks
guard = Guard().use(AfricanCompliance, on_fail="exception")

# CBN threshold
guard.validate("Transfer of NGN 10,000,000 approved.")
# → raises ValidationError: [CBN] Amount ₦10,000,000 exceeds mandatory CTR threshold

# Sensitive data
guard.validate("The customer's health record was retrieved.")
# → raises ValidationError: [NDPA] Special-category data detected

# Cross-border
guard.validate("Syncing customer records to China.")
# → raises ValidationError: [NDPA] Cross-border data transfer to 'China' detected

# Run specific checks only
guard_cbn = Guard().use(
    AfricanCompliance,
    checks=["cbn_threshold"],
    on_fail="exception"
)

# Scope sensitive data to specific frameworks
guard_ndpa_popia = Guard().use(
    AfricanCompliance,
    checks=["sensitive_data"],
    jurisdictions=["NDPA", "POPIA"],
    on_fail="exception"
)

Parameters

Available checks: sensitive_data, cbn_threshold, cbk_threshold, cross_border

Available jurisdictions: NDPA, POPIA, KDPA, GH_DPA, RW_DPA

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-pii — African PII detection validator