https://github.com/philterd/philterscope
A standalone PII redaction evaluation audit tool validates Philter performance with precision/recall metrics and suggests policy optimizations.
https://github.com/philterd/philterscope
evaluation phi philter pii precision recall redaction
Last synced: 29 days ago
JSON representation
A standalone PII redaction evaluation audit tool validates Philter performance with precision/recall metrics and suggests policy optimizations.
- Host: GitHub
- URL: https://github.com/philterd/philterscope
- Owner: philterd
- License: apache-2.0
- Created: 2026-04-14T18:00:11.000Z (2 months ago)
- Default Branch: main
- Last Pushed: 2026-04-24T17:32:20.000Z (2 months ago)
- Last Synced: 2026-04-24T19:27:31.816Z (2 months ago)
- Topics: evaluation, phi, philter, pii, precision, recall, redaction
- Language: Go
- Homepage: https://www.philterd.ai
- Size: 930 KB
- Stars: 1
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# PhilterScope
PhilterScope is a standalone CLI tool for PII redaction auditing and policy optimization. It allows you to audit the performance of [Philter](https://www.github.com/philterd/philter) by comparing its redaction results against a "golden dataset" of labeled PII.
PhilterScope is a core part of our framework for implementing PII/PHI redaction solutions. To learn more, visit us at [Philterd](https://www.philterd.ai). Professional services are available for custom PII redaction solutions.
## Documentation
- [Running PhilterScope](docs/running.md): Detailed explanation of commands and flags.
- [Environment Variables](docs/environment-variables.md): Available environment variables for configuration.
- [Development](docs/development.md): Instructions for building and testing the project.
## Quick Start
The following command will compare the raw text in the `examples/raw` directory against the golden dataset in `examples/golden` and generate an HTML report in the `examples/` directory.
```
./philterscope-audit --golden ./examples/golden/ --input ./examples/raw/ --output ./examples/ --threshold 0.75
```
To store the audit in MongoDB database, provide the database connection information:
```
PHILTERSCOPE_MONGODB_CONNECTION_STRING=mongodb://localhost:27017/philterscope ./philterscope-audit --golden ./examples/golden/ --input ./examples/raw/ --output ./examples/ --threshold 0.75
```
The following command will launch the evaluation UI on port 5000 and load the report generated in the previous step.
```
./philterscope-serve --report ./examples/report.json --port 5000
```
Likewise with audits, to view audit results stored in MongoDB database, provide the database connection information:
```
PHILTERSCOPE_MONGODB_CONNECTION_STRING=mongodb://localhost:27017/philterscope ./philterscope-serve --report ./examples/report.json --port 5000
```
See the [documentation](docs/running.md) for more details and options.
## License
Copyright 2026 Philterd, LLC. "Philter" is a registered trademark of Philterd, LLC. All rights reserved.
Licensed under the Apache License, Version 2.0.