Per gli sviluppatori

Integra l'anonimizzazione nel tuo stack

promptShield è disponibile come strumento CLI per le pipeline locali e come API Docker self-hosted per la tua infrastruttura. I tuoi dati non toccano mai i nostri server.

CLI e SDK Python

Installalo da PyPI e anonimizza i documenti dal tuo terminale o dai tuoi script Python. Integralo nelle pipeline CI/CD, nei flussi di lavoro di elaborazione in blocco o nelle applicazioni personalizzate.

bash
pip install promptshield-app

API Docker self-hosted

Distribuisci l'intera API di promptShield sulla tua infrastruttura con un singolo docker compose up. Endpoint RESTful per importazione, rilevamento, anonimizzazione e decodifica.

bash
docker pull promptshield/promptshield-api:latest
docker compose up -d

Avvio rapido

bash
# Rileva i dati sensibili in un documento
promptshield detect report.pdf -o report-pii.json

# Anonimizza ed esporta
promptshield anonymize report.pdf -o report-safe.pdf

# Ripristina i dati originali
promptshield detokenize ai-output.pdf -o restored.pdf

# Avvia il server API locale
promptshield serve --host 0.0.0.0 --port 8000

Opzioni di rilevamento

Ogni parametro esposto dall'app desktop è disponibile anche dalla CLI. Combina i flag o salvali come preset per lingua in demo/setup.json.

bash
# Imposta la lingua di rilevamento + il pacchetto di pattern per Paese
promptshield detect contract.pdf --language en --countries CA -o pii.json

# Sostituisci il motore di rilevamento delle entità (id del modello HuggingFace)
promptshield detect contract.pdf --ner-backend Davlan/bert-base-multilingual-cased-ner-hrl

# Disattiva i livelli + restringi il raggruppamento + filtra le entità solo su PERSON/ORG
promptshield detect contract.pdf --no-llm --fuzziness 0.5 --ner-types PERSON,ORG

# Aggiungi espressioni letterali che devono essere segnalate come dati sensibili (ripetibile)
promptshield detect contract.pdf -e SA-2026-0847 -e "84-329-1057"

# Carica tutte le impostazioni da demo/setup.json per lingua, poi crea un bundle per la revisione
promptshield detect contract.pdf --preset en --export-review -o contract.psreview
--language LANG

Codice ISO 639-1: en, fr, de, es, it, nl, pt. Determina il modello di entità + i pacchetti di pattern per lingua.

--countries CODES

Codici Paese ISO separati da virgole. CA abilita SIN/RAMQ/codici postali per tutte le province.

--ner-backend MODEL

spacy (leggero) o qualsiasi id di modello HuggingFace. Installa i motori BERT/GLiNER tramite promptshield models install.

--no-regex / --no-ner / --no-llm

Salta i singoli livelli quando sai quali ti servono.

--fuzziness 0.0-1.0

Aggressività del raggruppamento delle aree. 0 = rigoroso, 1 = permissivo.

--regex-types / --ner-types

Limita ogni livello a tipi di dati sensibili specifici (PERSON, ORG, EMAIL, …).

-e / --expression PATTERN

Testo letterale da segnalare come dato sensibile CUSTOM. Anteponi re: per una regex. Ripetibile.

--preset LOCALE

Carica tutti i parametri di rilevamento da demo/setup.json[locale]. I flag della CLI hanno comunque la priorità.

--export-review -o FILE.psreview

Raccogli il documento sorgente + le aree rilevate in uno ZIP .psreview — perfetto per le fixture o per il passaggio in revisione.

Interfaccia a riga di comando

Elabora i documenti dal tuo terminale con un solo comando. Rileva, anonimizza e decodifica, tutto offline.

API Docker self-hosted

Distribuiscila sulla tua infrastruttura con docker compose. API REST completa con documentazione Swagger interattiva su /docs.

SDK Python

Importa il motore principale direttamente nei tuoi script Python. Pieno supporto asincrono, type hint e modelli Pydantic.

Architettura a fiducia zero

Tutta l'elaborazione avviene all'interno del container o sul tuo dispositivo. Nessun dato viene inviato all'esterno, nemmeno a noi.

Tutti i formati di documento

PDF, DOCX, XLSX, PPTX, immagini (PNG, JPEG, TIFF, BMP, WebP). OCR per i documenti scansionati incluso.

Elaborazione in blocco

Elabora centinaia di documenti in modo programmatico. Corrispondenze di codici coerenti tra insiemi di documenti collegati.

La CLI e l'API self-hosted sono disponibili a partire dal piano Pro.

Google Cloud
Infrastructure
Sentry
Error Monitoring
Stripe
Billing
Cloudflare
Edge Security
Tauri 2
Desktop Shell
React 19
Frontend
Next.js 14
Website
Python
Runtime
Rust
Core Engine

Se automatizzi l'oscuramento invece di farlo a mano, i compromessi cambiano. La nostra guida mette a confronto le opzioni per gli sviluppatori — librerie, API in hosting e una CLI locale — e dove finiscono i tuoi documenti con ciascuna.

Leggi la guida