The built-in Pseudonymizer plugin keeps personal data away from the provider of a model. In a pseudonymized project, what its sessions send (prompts, files read, tool results) goes out with pseudonyms in place of names, places, phone numbers and identifiers: [PERSON_001], [LOCATION_002], [IBAN_001]. The real values stay on your computer, and the answers, the tool calls and the files the agent writes get them back.
Detection runs on your computer, in CodeAlta: patterns and checksums for identifiers, and for names a local model of the language of your documents. Nothing is sent to a service to find what to hide.
The plugin is for CodeAlta Desktop. In CodeAlta TUI, the sessions of a pseudonymized project send nothing.
sequenceDiagram
participant You
participant CodeAlta as CodeAlta (your computer)
participant Provider as Provider of the model
You->>CodeAlta: "Summarize the letter of Sophie Martin"
CodeAlta->>Provider: "Summarize the letter of [PERSON_001]"
Provider->>CodeAlta: "[PERSON_001] asks for…"
CodeAlta->>You: "Sophie Martin asks for…"
LOCATION: Montauban to choose the kind of pseudonym; older prefixes such as LIEU: still work.The same menu item, Pseudonymization…, changes these choices later or stops pseudonymizing the project. The choices are saved in the project's .alta/config.toml.
A session that sent pseudonyms once stays confidential: if the project stops being pseudonymized, it goes on pseudonymizing, since its history would otherwise go out in clear. Its sub-agents are confidential too.
Each project chooses the language of its documents, which chooses the model that finds names. A model is downloaded once, the first time a project needs it, and runs on your computer.
| Language | What it finds |
|---|---|
| French | Names of people, places and organizations in French, and the identifiers of France (NIR, SIRET…). |
| English | Names of people, places and organizations in English, and the identifiers of the UK and the US (NI, NHS, SSN…). |
| Several languages | Ten languages, French and English among them, and the identifiers of France, the UK and the US. |
| Identifiers only | Emails, phone numbers, IBAN, social security and company numbers of France, the UK and the US. Names are not looked for, and nothing is downloaded. |
Settings > Plugins > Pseudonymizer lists the languages with their model and its size, and deletes a model or downloads it again. A Custom model setting takes the folder of a token classification model of yours (ONNX, with its tokenizer and a ner-model.json that describes it). Descriptions that use older French kinds, such as PERSONNE, still work without edits or a new download.
People, contact details (emails, phone numbers, postal codes) and identifiers (bank accounts and cards, social security, passport and tax numbers…) are always hidden. Settings > Plugins > Pseudonymizer decides the rest, for every pseudonymized project:
| Setting | By default |
|---|---|
| Places | Hidden: streets, towns, regions and countries the model finds. |
| Organizations | Hidden: companies, firms and administrations the model finds. |
| Company numbers | Hidden: SIREN and SIRET, Companies House numbers, EIN. |
| Every date | Off: only dates of birth are hidden, the dates of acts and meetings are sent. |
| Web addresses | Off: links to documentation, a repository or a site are sent. |
| Words never hidden | CodeAlta, CodeAlta Desktop, noreply@codealta.io, and the technologies CodeAlta's own instructions name (CUDA, ROCm, Vulkan, Metal, EPUB, MarkItDotNet, Unicode, CI, PowerPoint, io): add the names of products or of your firm that name no one. A project whose party has one of these names lists it in Names always hidden. |
| Tools that get pseudonyms | The web tools and the pages of a browser. * stands for any characters. |
A pseudonymized session sends nothing it could not pseudonymize. The turn stops with a message that says why, when:
.alta/config.toml cannot be read, so CodeAlta cannot tell whether the project is pseudonymized;Detection finds most personal data, not all of it. A name the model misses, a rare spelling or the context ("the mayor of a small town") can still tell who someone is. Add the names that matter to Names always hidden, and check with try a text on a sample of your documents.
Pseudonymization covers the requests CodeAlta sends for the sessions of the project on this computer. It does not cover:
.alta/config.toml, beside its documents.