How shashi3070/aigov-redact works
aigov-redact is a local-first privacy gateway and redaction library for LLM workflows. Its main reversible path is application text through PrivacyGateway protection, then to an LLM, with the response returned to the session for resolution. A separate classic-redaction path supports one-shot detection and redaction; CLI commands expose detection, redaction, auditing, and usage history. The README documents policy profiles, optional NER, broad pattern coverage, and audit logging. Edges reflect shown calls, imports listed in the source index, or README statements; unsampled or optional integrations are left unverified.
Main entry points: session.py Gateway session · detector.py PII detector · main.py CLI commands · gateway.py PrivacyGateway
Components 20
Privacy gateway
- PrivacyGateway
src/aigov_redact/gateway/gateway.py - Gateway session
src/aigov_redact/gateway/session.py - Mapping vault
src/aigov_redact/mapping/vault.py - Token generator
src/aigov_redact/mapping/token_generator.py - Mapping session
src/aigov_redact/mapping/session.py - Number transformer
src/aigov_redact/transformation/numbers.py - Date transformer
src/aigov_redact/transformation/dates.py - Semantic abstraction
src/aigov_redact/transformation/semantic.py
Detection and policy
- Policy engine
src/aigov_redact/policy/engine.py - PII detector
src/aigov_redact/detector.py - PII patterns
src/aigov_redact/patterns.py - Optional NER
src/aigov_redact/ner/presidio.py - Result models
src/aigov_redact/models.py - Configuration
src/aigov_redact/config.py
Classic redaction
- Classic redactor
src/aigov_redact/redactor.py - CLI commands
src/aigov_redact/cli/main.py
Audit and usage
- Log auditor
src/aigov_redact/auditor.py - Usage history
src/aigov_redact/usage.py
Other components
- Application
- LLM service
Connections 31
- Application → PrivacyGateway: protects text
README.md - PrivacyGateway → Gateway session: creates session
src/aigov_redact/gateway/gateway.py - PrivacyGateway → PII detector: configures detector
src/aigov_redact/gateway/gateway.py - PrivacyGateway → Policy engine: selects policy
src/aigov_redact/gateway/gateway.py - PrivacyGateway → Semantic abstraction: configures abstraction
src/aigov_redact/gateway/gateway.py - Gateway session → PII detector: detects entities
src/aigov_redact/gateway/session.py - Gateway session → Policy engine: gets actions
src/aigov_redact/gateway/session.py - Gateway session → Mapping vault: registers mappings
src/aigov_redact/gateway/session.py - Gateway session → Number transformer: transforms numbers
src/aigov_redact/gateway/session.py - Gateway session → Date transformer: transforms dates
src/aigov_redact/gateway/session.py - Gateway session → LLM service: sends protected text
README.md - LLM service → Gateway session: returns response
README.md - Gateway session → Application: resolves response
README.md - Mapping session → Mapping vault: uses vault
src/aigov_redact/mapping/session.py - Mapping session → Token generator: creates generator
src/aigov_redact/mapping/session.py - Number transformer → Mapping vault: records transforms
src/aigov_redact/transformation/numbers.py - Date transformer → Mapping vault: records transforms
src/aigov_redact/transformation/dates.py - PII detector → PII patterns: matches patterns
src/aigov_redact/detector.py - PII detector → Result models: builds entities
src/aigov_redact/detector.py - Configuration → PII patterns: configures patterns
src/aigov_redact/config.py - PII detector → Optional NER
- Application → Classic redactor: redacts text
README.md - Classic redactor → PII detector: detects entities
- Application → CLI commands: runs commands
README.md - CLI commands → Configuration: loads configuration
src/aigov_redact/cli/main.py - CLI commands → PII detector: runs detection
src/aigov_redact/cli/main.py - CLI commands → Classic redactor: runs redaction
src/aigov_redact/cli/main.py - CLI commands → Log auditor: runs audits
src/aigov_redact/cli/main.py - CLI commands → Usage history: shows history
src/aigov_redact/cli/main.py - Log auditor → PII detector: scans content
src/aigov_redact/auditor.py - Log auditor → Result models: creates entries
src/aigov_redact/auditor.py