directorytree/privacy-filter-classifier

Framework agnostic PHP classifier for privacy-filter.cpp binaries.

v1.1.0 2026-06-18 14:30 UTC

Requires

• php: ^8.2
• symfony/process: ^6.4|^7.0|^8.0

Requires (Dev)

• laravel/pint: ^1.0
• pestphp/pest: ^3.0|^4.0

MIT

README

Privacy Filter Classifier

Framework agnostic PHP classifier for privacy-filter.cpp binaries.

Installation

You may install the package via Composer:

composer require directorytree/privacy-filter-classifier

Usage

Create a classifier using the local binary and model paths:

use DirectoryTree\PrivacyFilterClassifier\Classifier;

$classifier = new Classifier(
    binaryPath: '/path/to/privacy-filter',
    modelPath: '/path/to/privacy-filter-f16.gguf',
    timeout: 60,
);

$entities = $classifier->entities('Contact John Doe at [e-mail].');

You may provide a classification threshold at runtime. The threshold is the minimum confidence score an entity must meet before it is returned. Increasing the threshold returns fewer, higher-confidence entities, while decreasing it may return more entities with lower confidence:

$entities = $classifier->entities(
    text: 'Contact John Doe at [e-mail].',
    threshold: 0.75,
);

Entities

The entities method returns an array of DirectoryTree\PrivacyFilterClassifier\Entity instances:

/** @var \DirectoryTree\PrivacyFilterClassifier\Entity $entity */
foreach ($entities as $entity) {
    $entity->type;  // private_email
    $entity->text;  // [e-mail]
    $entity->start; // 20
    $entity->end;   // 36
    $entity->score; // 0.98
}