🕵️ Choosing a Replacement Strategy¶

Four replace mode strategies compared side-by-side on the same data.

Strategy	What it does
Substitute	LLM-generated contextual replacements
Redact	Label-based markers ([REDACTED_FIRST_NAME])
Annotate	Tags entities but keeps original text
Hash	Deterministic hash digest

📚 What you'll learn¶

• Compare Redact, Annotate, Hash, and Substitute on the same input
• Customize output formats with format_template
• Understand which strategy fits your use case (readability, determinism, privacy)

Tip: First time running notebooks? Start with setup instructions.

⚙️ Setup¶

• Install the notebook extra, then provide credentials for the configured external LLM providers.
• create_anonymizer() starts pinned GLiNER2 locally and selects CUDA, MPS, or CPU automatically.
• The default external LLM models currently use OpenRouter; its terms and privacy practices apply.

Data boundary: GLiNER2 detection runs locally in this notebook environment. LLM-assisted validation, augmentation, replacement, rewriting, repair, and evaluation use configured external hosts and may send them original or tagged input text. Do not treat this configuration as an all-local privacy boundary.

• configure_logging(LoggingConfig.default()) keeps logs at INFO. Switch to LoggingConfig.debug() when troubleshooting.

In [1]:

import getpass
import os
import subprocess
import sys

package_spec = os.getenv("ANONYMIZER_NOTEBOOK_PACKAGE", "nemo-anonymizer[notebooks]")
subprocess.check_call([sys.executable, "-m", "pip", "install", "--quiet", package_spec])

import getpass import os import subprocess import sys package_spec = os.getenv("ANONYMIZER_NOTEBOOK_PACKAGE", "nemo-anonymizer[notebooks]") subprocess.check_call([sys.executable, "-m", "pip", "install", "--quiet", package_spec])

Out[1]:

0

In [2]:

from anonymizer.notebooks import required_api_key_environment_variables

for variable in required_api_key_environment_variables():
    key = getpass.getpass(f"Enter {variable}: ").strip()
    if not key:
        raise RuntimeError(f"{variable} is required by the configured external model providers.")
    os.environ[variable] = key

from anonymizer.notebooks import required_api_key_environment_variables for variable in required_api_key_environment_variables(): key = getpass.getpass(f"Enter {variable}: ").strip() if not key: raise RuntimeError(f"{variable} is required by the configured external model providers.") os.environ[variable] = key

In [3]:

from anonymizer import (
    Annotate,
    AnonymizerConfig,
    AnonymizerInput,
    Hash,
    LoggingConfig,
    Redact,
    Substitute,
    configure_logging,
)
from anonymizer.notebooks import create_anonymizer, stop_local_runtime

configure_logging(LoggingConfig.default())

from anonymizer import ( Annotate, AnonymizerConfig, AnonymizerInput, Hash, LoggingConfig, Redact, Substitute, configure_logging, ) from anonymizer.notebooks import create_anonymizer, stop_local_runtime configure_logging(LoggingConfig.default())

In [4]:

anonymizer = create_anonymizer()

anonymizer = create_anonymizer()

[00:19:51] [INFO] 🔧 Anonymizer initialized with 5 model configs

[00:19:51] [INFO]   |-- 🔎 detector:  local-gliner2-pii

[00:19:51] [INFO]   |-- ✅ validator: gpt-oss-120b

[00:19:51] [INFO]   |-- 🧩 augmenter: gpt-oss-120b

GLiNER2 ready: model=fastino/gliner2-privacy-filter-PII-multi revision=59894c087cb2923b01f337d4ee72f6ff84d5bdd6 device=mps endpoint=http://127.0.0.1:54611/v1

📦 Input data¶

• We use the same biographies dataset throughout so each strategy is compared on identical input.

In [5]:

input_data = AnonymizerInput(
    source="https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv",
    text_column="biography",
    data_summary="Biographical profiles",
)

input_data = AnonymizerInput( source="https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv", text_column="biography", data_summary="Biographical profiles", )

🔄 Substitute¶

• Uses an LLM to generate contextually appropriate synthetic replacements.
  • The LLM considers the full document context matching names with emails, cities to states, etc.
• Customize with instructions to steer the LLM's replacement choices.

In [6]:

substitute_config = AnonymizerConfig(replace=Substitute())

substitute_preview = anonymizer.preview(
    config=substitute_config,
    data=input_data,
    num_records=3,
)

substitute_config = AnonymizerConfig(replace=Substitute()) substitute_preview = anonymizer.preview( config=substitute_config, data=input_data, num_records=3, )

[00:19:51] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:19:51] [INFO] 🔍 Running entity detection on 3 records

[00:19:51] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:21:28] [INFO]   |-- 📋 Detection complete — 84 entities found across 3 records (0 failed) [97.0s]

[00:21:28] [INFO]   |-- labels: first_name=23, occupation=6, age=5, field_of_study=5, company_name=5, city=4, organization_name=4, degree=4, university=4, last_name=3, state=3, language=3, political_view=3, religious_belief=3, place_name=2, race_ethnicity=2, street_address=2, nationality=1, date_of_birth=1, landmark=1

[00:21:28] [INFO] 🔄 Running Substitute replacement

[00:22:12] [INFO]   |-- 📋 Replacement complete (0 failed) [44.0s]

[00:22:12] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

In [7]:

substitute_preview.display_record(0)

substitute_preview.display_record(0)

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| degree at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

Ethan| first_name Kline| last_name, a 52-year-old| age Canadian| nationality marine biologist| occupation living in Portland| city, Oregon| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Lincoln High School| organization_name, he earned his Doctor of Medicine (MD)| degree at the Oregon State University| university, where he also completed a research stint in marine ecology| field_of_study. Fluent in Spanish| language, Ethan| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to plant conservation| field_of_study. Since finishing his training, Ethan| first_name has worked at Pacific Pet Clinic| organization_name and later at the Willamette Animal Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Libertarian| political_view and often volunteers at local shelters, a habit encouraged by his wife, Sofia| first_name, and their two teenage children, Jenna| first_name and Noah| first_name. Outside the clinic, Ethan| first_name enjoys hiking the Cascade Range| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
40‑year‑old	age	52-year-old
Aria	first_name	Jenna
Bobby	first_name	Ethan
Christian Democrat	political_view	Libertarian
Colorado	state	Oregon
Colorado Veterinary Clinic	organization_name	Willamette Animal Clinic
DVM	degree	Doctor of Medicine (MD)
Denver	city	Portland
English	language	Spanish
Jefferson High	organization_name	Lincoln High School
Leo	first_name	Noah
Maya	first_name	Sofia
Mexican	nationality	Canadian
Rockies	place_name	Cascade Range
University of Colorado Boulder	university	Oregon State University
VCA Animal Hospital	organization_name	Pacific Pet Clinic
Watford	last_name	Kline
animal care	field_of_study	plant conservation
veterinarian	occupation	marine biologist
wildlife health	field_of_study	marine ecology

Custom instructions¶

• Pass instructions to guide the LLM -- e.g. keep replacements within a specific region, culture, or naming convention.

In [8]:

substitute_custom_config = AnonymizerConfig(
    replace=Substitute(instructions="Use only Japanese names and locations for all replacements.")
)
substitute_custom_preview = anonymizer.preview(
    config=substitute_custom_config,
    data=input_data,
    num_records=3,
)
substitute_custom_preview.display_record(0)

substitute_custom_config = AnonymizerConfig( replace=Substitute(instructions="Use only Japanese names and locations for all replacements.") ) substitute_custom_preview = anonymizer.preview( config=substitute_custom_config, data=input_data, num_records=3, ) substitute_custom_preview.display_record(0)

[00:22:14] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:22:14] [INFO] 🔍 Running entity detection on 3 records

[00:22:14] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:23:33] [INFO]   |-- 📋 Detection complete — 84 entities found across 3 records (0 failed) [78.6s]

[00:23:33] [INFO]   |-- labels: first_name=23, occupation=6, company_name=6, age=5, field_of_study=5, city=4, organization_name=4, degree=4, university=4, last_name=3, state=3, language=3, political_view=3, place_name=2, race_ethnicity=2, street_address=2, religious_belief=2, nationality=1, date_of_birth=1, landmark=1

[00:23:33] [INFO] 🔄 Running Substitute replacement

[00:24:01] [INFO]   |-- 📋 Replacement complete (0 failed) [28.5s]

[00:24:01] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| degree at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

Haruto| first_name Tanaka| last_name, a 45‑year‑old| age Japanese| nationality zoologist| occupation living in Sapporo| city, Hokkaido| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Kobe High School| organization_name, he earned his Bachelor of Science| degree at the University of Tokyo| university, where he also completed a research stint in marine biology| field_of_study. Fluent in Japanese| language, Haruto| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to public health| field_of_study. Since finishing his training, Haruto| first_name has worked at Sapporo Animal Hospital| organization_name and later at the Hokkaido Veterinary Center| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Liberal Democratic Party member| political_view and often volunteers at local shelters, a habit encouraged by his wife, Sakura| first_name, and their two teenage children, Yui| first_name and Kaito| first_name. Outside the clinic, Haruto| first_name enjoys hiking the Japanese Alps| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
40‑year‑old	age	45‑year‑old
Aria	first_name	Yui
Bobby	first_name	Haruto
Christian Democrat	political_view	Liberal Democratic Party member
Colorado	state	Hokkaido
Colorado Veterinary Clinic	organization_name	Hokkaido Veterinary Center
DVM	degree	Bachelor of Science
Denver	city	Sapporo
English	language	Japanese
Jefferson High	organization_name	Kobe High School
Leo	first_name	Kaito
Maya	first_name	Sakura
Mexican	nationality	Japanese
Rockies	place_name	Japanese Alps
University of Colorado Boulder	university	University of Tokyo
VCA Animal Hospital	organization_name	Sapporo Animal Hospital
Watford	last_name	Tanaka
animal care	field_of_study	public health
veterinarian	occupation	zoologist
wildlife health	field_of_study	marine biology

🚫 Redact¶

• Replaces each entity with a label-based marker. Default: [REDACTED_FIRST_NAME].
• Customize with Redact(format_template=...).

In [9]:

redact_config = AnonymizerConfig(replace=Redact())

redact_preview = anonymizer.preview(
    config=redact_config,
    data=input_data,
    num_records=3,
)

redact_preview.display_record(0)

redact_config = AnonymizerConfig(replace=Redact()) redact_preview = anonymizer.preview( config=redact_config, data=input_data, num_records=3, ) redact_preview.display_record(0)

[00:24:02] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:24:02] [INFO] 🔍 Running entity detection on 3 records

[00:24:02] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:25:20] [INFO]   |-- 📋 Detection complete — 85 entities found across 3 records (0 failed) [77.7s]

[00:25:20] [INFO]   |-- labels: first_name=23, occupation=6, age=5, university=5, field_of_study=5, organization_name=5, company_name=5, city=4, last_name=3, state=3, language=3, political_view=3, degree=3, place_name=2, race_ethnicity=2, street_address=2, religious_belief=2, nationality=1, education_level=1, date_of_birth=1, landmark=1

[00:25:20] [INFO] 🔄 Running Redact replacement

[00:25:20] [INFO]   |-- 📋 Replacement complete (0 failed) [0.0s]

[00:25:20] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| university, he earned his DVM| education_level at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

[REDACTED_FIRST_NAME]| first_name [REDACTED_LAST_NAME]| last_name, a [REDACTED_AGE]| age [REDACTED_NATIONALITY]| nationality [REDACTED_OCCUPATION]| occupation living in [REDACTED_CITY]| city, [REDACTED_STATE]| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from [REDACTED_UNIVERSITY]| university, he earned his [REDACTED_EDUCATION_LEVEL]| education_level at the [REDACTED_UNIVERSITY]| university, where he also completed a research stint in [REDACTED_FIELD_OF_STUDY]| field_of_study. Fluent in [REDACTED_LANGUAGE]| language, [REDACTED_FIRST_NAME]| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to [REDACTED_FIELD_OF_STUDY]| field_of_study. Since finishing his training, [REDACTED_FIRST_NAME]| first_name has worked at [REDACTED_ORGANIZATION_NAME]| organization_name and later at the [REDACTED_ORGANIZATION_NAME]| organization_name, where he now leads a busy mixed‑practice team. He identifies as a [REDACTED_POLITICAL_VIEW]| political_view and often volunteers at local shelters, a habit encouraged by his wife, [REDACTED_FIRST_NAME]| first_name, and their two teenage children, [REDACTED_FIRST_NAME]| first_name and [REDACTED_FIRST_NAME]| first_name. Outside the clinic, [REDACTED_FIRST_NAME]| first_name enjoys hiking the [REDACTED_PLACE_NAME]| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
Bobby	first_name	[REDACTED_FIRST_NAME]
Watford	last_name	[REDACTED_LAST_NAME]
40‑year‑old	age	[REDACTED_AGE]
Mexican	nationality	[REDACTED_NATIONALITY]
veterinarian	occupation	[REDACTED_OCCUPATION]
Denver	city	[REDACTED_CITY]
Colorado	state	[REDACTED_STATE]
Jefferson High	university	[REDACTED_UNIVERSITY]
DVM	education_level	[REDACTED_EDUCATION_LEVEL]
University of Colorado Boulder	university	[REDACTED_UNIVERSITY]
wildlife health	field_of_study	[REDACTED_FIELD_OF_STUDY]
English	language	[REDACTED_LANGUAGE]
animal care	field_of_study	[REDACTED_FIELD_OF_STUDY]
VCA Animal Hospital	organization_name	[REDACTED_ORGANIZATION_NAME]
Colorado Veterinary Clinic	organization_name	[REDACTED_ORGANIZATION_NAME]
Christian Democrat	political_view	[REDACTED_POLITICAL_VIEW]
Maya	first_name	[REDACTED_FIRST_NAME]
Aria	first_name	[REDACTED_FIRST_NAME]
Leo	first_name	[REDACTED_FIRST_NAME]
Rockies	place_name	[REDACTED_PLACE_NAME]

Custom template¶

• format_template="***" replaces every entity with the same constant.

In [10]:

custom_config = AnonymizerConfig(replace=Redact(format_template="***"))

custom_preview = anonymizer.preview(
    config=custom_config,
    data=input_data,
    num_records=3,
)

custom_preview.display_record(0)

custom_config = AnonymizerConfig(replace=Redact(format_template="***")) custom_preview = anonymizer.preview( config=custom_config, data=input_data, num_records=3, ) custom_preview.display_record(0)

[00:25:21] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:25:21] [INFO] 🔍 Running entity detection on 3 records

[00:25:21] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:26:20] [INFO]   |-- 📋 Detection complete — 85 entities found across 3 records (0 failed) [58.9s]

[00:26:20] [INFO]   |-- labels: first_name=23, occupation=6, age=5, organization_name=5, field_of_study=5, company_name=5, city=4, university=4, last_name=3, state=3, language=3, political_view=3, degree=3, religious_belief=3, place_name=2, race_ethnicity=2, street_address=2, nationality=1, education_level=1, date_of_birth=1, landmark=1

[00:26:20] [INFO] 🔄 Running Redact replacement

[00:26:20] [INFO]   |-- 📋 Replacement complete (0 failed) [0.0s]

[00:26:20] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| education_level at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

***| first_name ***| last_name, a ***| age ***| nationality ***| occupation living in ***| city, ***| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from ***| organization_name, he earned his ***| education_level at the ***| university, where he also completed a research stint in ***| field_of_study. Fluent in ***| language, ***| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to ***| field_of_study. Since finishing his training, ***| first_name has worked at ***| organization_name and later at the ***| organization_name, where he now leads a busy mixed‑practice team. He identifies as a ***| political_view and often volunteers at local shelters, a habit encouraged by his wife, ***| first_name, and their two teenage children, ***| first_name and ***| first_name. Outside the clinic, ***| first_name enjoys hiking the ***| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
Bobby	first_name	***
Watford	last_name	***
40‑year‑old	age	***
Mexican	nationality	***
veterinarian	occupation	***
Denver	city	***
Colorado	state	***
Jefferson High	organization_name	***
DVM	education_level	***
University of Colorado Boulder	university	***
wildlife health	field_of_study	***
English	language	***
animal care	field_of_study	***
VCA Animal Hospital	organization_name	***
Colorado Veterinary Clinic	organization_name	***
Christian Democrat	political_view	***
Maya	first_name	***
Aria	first_name	***
Leo	first_name	***
Rockies	place_name	***

🏷️ Annotate¶

• Tags each entity with its label but keeps the original text visible. Default: <Alice, first_name>.
• Customize with format_template -- must include {text} and {label}, e.g. Annotate(format_template="<{text}-|-{label}>").

In [11]:

annotate_config = AnonymizerConfig(replace=Annotate())

annotate_preview = anonymizer.preview(
    config=annotate_config,
    data=input_data,
    num_records=3,
)

annotate_preview.display_record(0)

annotate_config = AnonymizerConfig(replace=Annotate()) annotate_preview = anonymizer.preview( config=annotate_config, data=input_data, num_records=3, ) annotate_preview.display_record(0)

[00:26:21] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:26:21] [INFO] 🔍 Running entity detection on 3 records

[00:26:21] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:26:58] [INFO]   |-- 📋 Detection complete — 85 entities found across 3 records (0 failed) [36.7s]

[00:26:58] [INFO]   |-- labels: first_name=23, occupation=6, age=5, organization_name=5, field_of_study=5, company_name=5, city=4, degree=4, university=4, last_name=3, state=3, language=3, political_view=3, religious_belief=3, place_name=2, race_ethnicity=2, street_address=2, nationality=1, date_of_birth=1, landmark=1

[00:26:58] [INFO] 🔄 Running Annotate replacement

[00:26:58] [INFO]   |-- 📋 Replacement complete (0 failed) [0.0s]

[00:26:58] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| degree at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

<Bobby, first_name>| first_name <Watford, last_name>| last_name, a <40‑year‑old, age>| age <Mexican, nationality>| nationality <veterinarian, occupation>| occupation living in <Denver, city>| city, <Colorado, state>| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from <Jefferson High, organization_name>| organization_name, he earned his <DVM, degree>| degree at the <University of Colorado Boulder, university>| university, where he also completed a research stint in <wildlife health, field_of_study>| field_of_study. Fluent in <English, language>| language, <Bobby, first_name>| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to <animal care, field_of_study>| field_of_study. Since finishing his training, <Bobby, first_name>| first_name has worked at <VCA Animal Hospital, organization_name>| organization_name and later at the <Colorado Veterinary Clinic, organization_name>| organization_name, where he now leads a busy mixed‑practice team. He identifies as a <Christian Democrat, political_view>| political_view and often volunteers at local shelters, a habit encouraged by his wife, <Maya, first_name>| first_name, and their two teenage children, <Aria, first_name>| first_name and <Leo, first_name>| first_name. Outside the clinic, <Bobby, first_name>| first_name enjoys hiking the <Rockies, place_name>| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
Bobby	first_name	<Bobby, first_name>
Watford	last_name	<Watford, last_name>
40‑year‑old	age	<40‑year‑old, age>
Mexican	nationality	<Mexican, nationality>
veterinarian	occupation	<veterinarian, occupation>
Denver	city	<Denver, city>
Colorado	state	<Colorado, state>
Jefferson High	organization_name	<Jefferson High, organization_name>
DVM	degree	<DVM, degree>
University of Colorado Boulder	university	<University of Colorado Boulder, university>
wildlife health	field_of_study	<wildlife health, field_of_study>
English	language	<English, language>
animal care	field_of_study	<animal care, field_of_study>
VCA Animal Hospital	organization_name	<VCA Animal Hospital, organization_name>
Colorado Veterinary Clinic	organization_name	<Colorado Veterinary Clinic, organization_name>
Christian Democrat	political_view	<Christian Democrat, political_view>
Maya	first_name	<Maya, first_name>
Aria	first_name	<Aria, first_name>
Leo	first_name	<Leo, first_name>
Rockies	place_name	<Rockies, place_name>

Custom template¶

• Override the default format with any string containing {text} and {label}.

In [12]:

annotate_custom_config = AnonymizerConfig(replace=Annotate(format_template="<{text}-|-{label}>"))
annotate_custom_preview = anonymizer.preview(
    config=annotate_custom_config,
    data=input_data,
    num_records=3,
)
annotate_custom_preview.display_record(0)

annotate_custom_config = AnonymizerConfig(replace=Annotate(format_template="<{text}-|-{label}>")) annotate_custom_preview = anonymizer.preview( config=annotate_custom_config, data=input_data, num_records=3, ) annotate_custom_preview.display_record(0)

[00:26:59] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:26:59] [INFO] 🔍 Running entity detection on 3 records

[00:26:59] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:27:58] [INFO]   |-- 📋 Detection complete — 83 entities found across 3 records (0 failed) [59.4s]

[00:27:58] [INFO]   |-- labels: first_name=23, occupation=6, age=5, field_of_study=5, company_name=5, city=4, organization_name=4, degree=4, university=4, last_name=3, state=3, language=3, political_view=3, place_name=2, race_ethnicity=2, street_address=2, religious_belief=2, nationality=1, date_of_birth=1, landmark=1

[00:27:58] [INFO] 🔄 Running Annotate replacement

[00:27:58] [INFO]   |-- 📋 Replacement complete (0 failed) [0.0s]

[00:27:58] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| degree at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

<Bobby-|-first_name>| first_name <Watford-|-last_name>| last_name, a <40‑year‑old-|-age>| age <Mexican-|-nationality>| nationality <veterinarian-|-occupation>| occupation living in <Denver-|-city>| city, <Colorado-|-state>| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from <Jefferson High-|-organization_name>| organization_name, he earned his <DVM-|-degree>| degree at the <University of Colorado Boulder-|-university>| university, where he also completed a research stint in <wildlife health-|-field_of_study>| field_of_study. Fluent in <English-|-language>| language, <Bobby-|-first_name>| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to <animal care-|-field_of_study>| field_of_study. Since finishing his training, <Bobby-|-first_name>| first_name has worked at <VCA Animal Hospital-|-organization_name>| organization_name and later at the <Colorado Veterinary Clinic-|-organization_name>| organization_name, where he now leads a busy mixed‑practice team. He identifies as a <Christian Democrat-|-political_view>| political_view and often volunteers at local shelters, a habit encouraged by his wife, <Maya-|-first_name>| first_name, and their two teenage children, <Aria-|-first_name>| first_name and <Leo-|-first_name>| first_name. Outside the clinic, <Bobby-|-first_name>| first_name enjoys hiking the <Rockies-|-place_name>| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
Bobby	first_name	<Bobby-|-first_name>
Watford	last_name	<Watford-|-last_name>
40‑year‑old	age	<40‑year‑old-|-age>
Mexican	nationality	<Mexican-|-nationality>
veterinarian	occupation	<veterinarian-|-occupation>
Denver	city	<Denver-|-city>
Colorado	state	<Colorado-|-state>
Jefferson High	organization_name	<Jefferson High-|-organization_name>
DVM	degree	<DVM-|-degree>
University of Colorado Boulder	university	<University of Colorado Boulder-|-university>
wildlife health	field_of_study	<wildlife health-|-field_of_study>
English	language	<English-|-language>
animal care	field_of_study	<animal care-|-field_of_study>
VCA Animal Hospital	organization_name	<VCA Animal Hospital-|-organization_name>
Colorado Veterinary Clinic	organization_name	<Colorado Veterinary Clinic-|-organization_name>
Christian Democrat	political_view	<Christian Democrat-|-political_view>
Maya	first_name	<Maya-|-first_name>
Aria	first_name	<Aria-|-first_name>
Leo	first_name	<Leo-|-first_name>
Rockies	place_name	<Rockies-|-place_name>

#️⃣ Hash¶

• Deterministic -- same input always produces the same hash.
• Customize with format_template (must include {digest}), algorithm (sha256/sha1/md5), and digest_length (6-64 characters).

In [13]:

hash_config = AnonymizerConfig(replace=Hash())

hash_preview = anonymizer.preview(
    config=hash_config,
    data=input_data,
    num_records=3,
)

hash_preview.display_record(0)

hash_config = AnonymizerConfig(replace=Hash()) hash_preview = anonymizer.preview( config=hash_config, data=input_data, num_records=3, ) hash_preview.display_record(0)

[00:27:59] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:27:59] [INFO] 🔍 Running entity detection on 3 records

[00:27:59] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:28:36] [INFO]   |-- 📋 Detection complete — 83 entities found across 3 records (0 failed) [37.1s]

[00:28:36] [INFO]   |-- labels: first_name=23, occupation=6, age=5, university=5, field_of_study=5, company_name=5, city=4, last_name=3, state=3, language=3, organization_name=3, political_view=3, degree=3, place_name=2, race_ethnicity=2, street_address=2, religious_belief=2, nationality=1, education_level=1, date_of_birth=1, landmark=1

[00:28:36] [INFO] 🔄 Running Hash replacement

[00:28:36] [INFO]   |-- 📋 Replacement complete (0 failed) [0.0s]

[00:28:36] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| university, he earned his DVM| education_level at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

<HASH_FIRST_NAME_4a70dab2cb4d>| first_name <HASH_LAST_NAME_e2efa8a62600>| last_name, a <HASH_AGE_c19577d3d98d>| age <HASH_NATIONALITY_d108dfd1df5c>| nationality <HASH_OCCUPATION_52a469e4d8e9>| occupation living in <HASH_CITY_fcdeb8c07d4a>| city, <HASH_STATE_4ae62bf4e804>| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from <HASH_UNIVERSITY_39dde416149c>| university, he earned his <HASH_EDUCATION_LEVEL_d44ae5e206d1>| education_level at the <HASH_UNIVERSITY_bca201129c41>| university, where he also completed a research stint in <HASH_FIELD_OF_STUDY_c27b00db54db>| field_of_study. Fluent in <HASH_LANGUAGE_ba118bf7fc9c>| language, <HASH_FIRST_NAME_4a70dab2cb4d>| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to <HASH_FIELD_OF_STUDY_a859e2065ef4>| field_of_study. Since finishing his training, <HASH_FIRST_NAME_4a70dab2cb4d>| first_name has worked at <HASH_ORGANIZATION_NAME_56e3eb3da5fa>| organization_name and later at the <HASH_ORGANIZATION_NAME_b45afd893ae9>| organization_name, where he now leads a busy mixed‑practice team. He identifies as a <HASH_POLITICAL_VIEW_1eba4d0314c9>| political_view and often volunteers at local shelters, a habit encouraged by his wife, <HASH_FIRST_NAME_031e45c699d1>| first_name, and their two teenage children, <HASH_FIRST_NAME_736001faca59>| first_name and <HASH_FIRST_NAME_5bc426e8d81e>| first_name. Outside the clinic, <HASH_FIRST_NAME_4a70dab2cb4d>| first_name enjoys hiking the <HASH_PLACE_NAME_d706f1c04961>| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
Bobby	first_name	<HASH_FIRST_NAME_4a70dab2cb4d>
Watford	last_name	<HASH_LAST_NAME_e2efa8a62600>
40‑year‑old	age	<HASH_AGE_c19577d3d98d>
Mexican	nationality	<HASH_NATIONALITY_d108dfd1df5c>
veterinarian	occupation	<HASH_OCCUPATION_52a469e4d8e9>
Denver	city	<HASH_CITY_fcdeb8c07d4a>
Colorado	state	<HASH_STATE_4ae62bf4e804>
Jefferson High	university	<HASH_UNIVERSITY_39dde416149c>
DVM	education_level	<HASH_EDUCATION_LEVEL_d44ae5e206d1>
University of Colorado Boulder	university	<HASH_UNIVERSITY_bca201129c41>
wildlife health	field_of_study	<HASH_FIELD_OF_STUDY_c27b00db54db>
English	language	<HASH_LANGUAGE_ba118bf7fc9c>
animal care	field_of_study	<HASH_FIELD_OF_STUDY_a859e2065ef4>
VCA Animal Hospital	organization_name	<HASH_ORGANIZATION_NAME_56e3eb3da5fa>
Colorado Veterinary Clinic	organization_name	<HASH_ORGANIZATION_NAME_b45afd893ae9>
Christian Democrat	political_view	<HASH_POLITICAL_VIEW_1eba4d0314c9>
Maya	first_name	<HASH_FIRST_NAME_031e45c699d1>
Aria	first_name	<HASH_FIRST_NAME_736001faca59>
Leo	first_name	<HASH_FIRST_NAME_5bc426e8d81e>
Rockies	place_name	<HASH_PLACE_NAME_d706f1c04961>

Custom template¶

• Override the algorithm, digest length, and output format.

In [14]:

hash_custom_config = AnonymizerConfig(replace=Hash(algorithm="md5", digest_length=8, format_template="[{digest}]"))
hash_custom_preview = anonymizer.preview(
    config=hash_custom_config,
    data=input_data,
    num_records=3,
)
hash_custom_preview.display_record(0)

hash_custom_config = AnonymizerConfig(replace=Hash(algorithm="md5", digest_length=8, format_template="[{digest}]")) hash_custom_preview = anonymizer.preview( config=hash_custom_config, data=input_data, num_records=3, ) hash_custom_preview.display_record(0)

[00:28:37] [INFO] 👀 Preview mode: 📂 Loaded 3 records from https://raw.githubusercontent.com/NVIDIA-NeMo/Anonymizer/refs/heads/main/docs/data/NVIDIA_synthetic_biographies.csv (column: 'biography')

[00:28:37] [INFO] 🔍 Running entity detection on 3 records

[00:28:37] [INFO] detection labels in scope: (default: 65 labels; see anonymizer.DEFAULT_ENTITY_LABELS for list)

[00:29:55] [INFO]   |-- 📋 Detection complete — 84 entities found across 3 records (0 failed) [78.0s]

[00:29:55] [INFO]   |-- labels: first_name=22, occupation=6, age=5, organization_name=5, field_of_study=5, company_name=5, city=4, degree=4, university=4, last_name=3, state=3, language=3, political_view=3, religious_belief=3, place_name=2, race_ethnicity=2, street_address=2, nationality=1, date_of_birth=1, landmark=1

[00:29:55] [INFO] 🔄 Running Hash replacement

[00:29:55] [INFO]   |-- 📋 Replacement complete (0 failed) [0.0s]

[00:29:55] [INFO] 🎉 Pipeline complete — 3 records processed, 0 total failures

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| degree at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

[657b3da9]| first_name [6e424e2c]| last_name, a [7d5ce251]| age [a0e769d8]| nationality [84c99b4a]| occupation living in [67100af8]| city, [15e49475]| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from [27c56955]| organization_name, he earned his [47211f54]| degree at the [e2b97348]| university, where he also completed a research stint in [7b2947bb]| field_of_study. Fluent in [78463a38]| language, [657b3da9]| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to [7034d6bf]| field_of_study. Since finishing his training, [657b3da9]| first_name has worked at [3541ebe8]| organization_name and later at the [cd3abcd1]| organization_name, where he now leads a busy mixed‑practice team. He identifies as a [408d2599]| political_view and often volunteers at local shelters, a habit encouraged by his wife, [719fe280]| first_name, and their two teenage children, [a1a013e2]| first_name and [550eadb8]| first_name. Outside the clinic, [657b3da9]| first_name enjoys hiking the [661f0bd9]| place_name with his family and mentoring veterinary students from his alma mater.

Replacement Map

Original	Label	Replacement
Bobby	first_name	[657b3da9]
Watford	last_name	[6e424e2c]
40‑year‑old	age	[7d5ce251]
Mexican	nationality	[a0e769d8]
veterinarian	occupation	[84c99b4a]
Denver	city	[67100af8]
Colorado	state	[15e49475]
Jefferson High	organization_name	[27c56955]
DVM	degree	[47211f54]
University of Colorado Boulder	university	[e2b97348]
wildlife health	field_of_study	[7b2947bb]
English	language	[78463a38]
animal care	field_of_study	[7034d6bf]
VCA Animal Hospital	organization_name	[3541ebe8]
Colorado Veterinary Clinic	organization_name	[cd3abcd1]
Christian Democrat	political_view	[408d2599]
Maya	first_name	[719fe280]
Aria	first_name	[a1a013e2]
Leo	first_name	[550eadb8]
Rockies	place_name	[661f0bd9]

📊 (Optional) Evaluate each strategy¶

• evaluate() is a separate, opt-in step that scores the output with LLM-as-judge metrics. Which metrics fire depends on the strategy:
  • Substitute → 4 metrics (Detection Validity + Type Fidelity + Relational Consistency + Attribute Fidelity).
  • Redact / Annotate / Hash → Detection Validity only (no replacement map to score type/relational/attribute against).
• Below shows it on the Substitute preview to surface all four; the same call works on redact_preview, annotate_preview, or hash_preview.

In [15]:

substitute_evaluated = anonymizer.evaluate(substitute_preview)
substitute_evaluated.display_record(0)

substitute_evaluated = anonymizer.evaluate(substitute_preview) substitute_evaluated.display_record(0)

[00:29:55] [INFO] 🧪 Running Substitute evaluation on 3 records

[00:29:55] [INFO]   |-- ⚖️ Running replace judges

[00:32:47] [INFO]   |-- 📋 Replace judges complete [171.3s]

[00:32:47] [INFO] 🎉 Evaluation complete — 3 records processed [171.3s]

Anonymizer Preview (record 0)

Original

Bobby| first_name Watford| last_name, a 40‑year‑old| age Mexican| nationality veterinarian| occupation living in Denver| city, Colorado| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Jefferson High| organization_name, he earned his DVM| degree at the University of Colorado Boulder| university, where he also completed a research stint in wildlife health| field_of_study. Fluent in English| language, Bobby| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to animal care| field_of_study. Since finishing his training, Bobby| first_name has worked at VCA Animal Hospital| organization_name and later at the Colorado Veterinary Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Christian Democrat| political_view and often volunteers at local shelters, a habit encouraged by his wife, Maya| first_name, and their two teenage children, Aria| first_name and Leo| first_name. Outside the clinic, Bobby| first_name enjoys hiking the Rockies| place_name with his family and mentoring veterinary students from his alma mater.

Replaced

Ethan| first_name Kline| last_name, a 52-year-old| age Canadian| nationality marine biologist| occupation living in Portland| city, Oregon| state, grew up on the outskirts of the city and developed a love for animals early on. After graduating from Lincoln High School| organization_name, he earned his Doctor of Medicine (MD)| degree at the Oregon State University| university, where he also completed a research stint in marine ecology| field_of_study. Fluent in Spanish| language, Ethan| first_name has always described his upbringing as a blend of small‑town curiosity and the vibrant culture of his community, values that continue to shape his compassionate approach to plant conservation| field_of_study. Since finishing his training, Ethan| first_name has worked at Pacific Pet Clinic| organization_name and later at the Willamette Animal Clinic| organization_name, where he now leads a busy mixed‑practice team. He identifies as a Libertarian| political_view and often volunteers at local shelters, a habit encouraged by his wife, Sofia| first_name, and their two teenage children, Jenna| first_name and Noah| first_name. Outside the clinic, Ethan| first_name enjoys hiking the Cascade Range| place_name with his family and mentoring veterinary students from his alma mater.

Entity Coverage

Entity Coverage: Satisfied — 16/16 (100%)

Type Fidelity

Type Fidelity: Satisfied (Judge Agreement: 20/20)

Attribute Fidelity

Attribute Fidelity: Satisfied (Judge Agreement: 5/5)

Show 5 evaluated entity(ies)

Original	Label	Synthetic	Attributes	Status	Reason
40‑year‑old	age	52-year-old	age_bucket	Pass	Age bucket preserved (adult to adjacent middle‑aged bucket).
Aria	first_name	Jenna	gender	Pass	Gender preserved (female).
Bobby	first_name	Ethan	gender	Pass	Gender preserved (male).
Leo	first_name	Noah	gender	Pass	Gender preserved (male).
Maya	first_name	Sofia	gender	Pass	Gender preserved (female).

Relational Consistency

Relational Consistency: Partially Satisfied (Judge Agreement: 5/6)

Show 6 checked relation(s)

Relation	Entities	Status	Reason
city <-> state	Denver (city) -> Portland, Colorado (state) -> Oregon	Pass	Portland is a city in Oregon, so the relation holds.
pronoun gender consistency	Bobby (first_name) -> Ethan	Pass	The text uses 'he' for Ethan, matching the male name.
occupation <-> degree	veterinarian (occupation) -> marine biologist, DVM (degree) -> Doctor of Medicine (MD)	Fail	A marine biologist would not typically hold an MD degree, indicating a mismatch.
occupation <-> organization (Pacific Pet Clinic)	veterinarian (occupation) -> marine biologist, VCA Animal Hospital (organization_name) -> Pacific Pet Clinic	Pass	A marine biologist could plausibly work at a pet clinic, so the relation holds.
occupation <-> organization (Willamette Animal Clinic)	veterinarian (occupation) -> marine biologist, Colorado Veterinary Clinic (organization_name) -> Willamette Animal Clinic	Pass	A marine biologist could plausibly work at a veterinary clinic, so the relation holds.
age <-> occupation	40‑year‑old (age) -> 52-year-old, veterinarian (occupation) -> marine biologist	Pass	A 52‑year‑old can be a marine biologist, so the relation holds.

Replacement Map

Original	Label	Replacement
40‑year‑old	age	52-year-old
Aria	first_name	Jenna
Bobby	first_name	Ethan
Christian Democrat	political_view	Libertarian
Colorado	state	Oregon
Colorado Veterinary Clinic	organization_name	Willamette Animal Clinic
DVM	degree	Doctor of Medicine (MD)
Denver	city	Portland
English	language	Spanish
Jefferson High	organization_name	Lincoln High School
Leo	first_name	Noah
Maya	first_name	Sofia
Mexican	nationality	Canadian
Rockies	place_name	Cascade Range
University of Colorado Boulder	university	Oregon State University
VCA Animal Hospital	organization_name	Pacific Pet Clinic
Watford	last_name	Kline
animal care	field_of_study	plant conservation
veterinarian	occupation	marine biologist
wildlife health	field_of_study	marine ecology

⏭️ Next steps¶

• 🕵️ Inspecting Detected Entities -- dig into what the detection pipeline found and debug quality.
• ✏️ Rewriting Biographies -- generate privacy-safe paraphrases instead of token-level replacements.
• ⚖️ Rewriting Legal Documents -- rewrite legal text with domain-specific privacy goals.

In [16]:

stop_local_runtime()

stop_local_runtime()