Skip to content

RAGbase Shield 0.4.0

Choose a tag to compare

@abdelhadi-azouni abdelhadi-azouni released this 12 Nov 14:33
· 81 commits to main since this release

RAGbase Shield 0.4.0

Utilisez Claude sur vos dossiers clients. Shield masque les données de vos clients avant l'envoi.

Le meilleur moteur de pseudonymisation du marché.

RAGbase Shield est un outil gratuit et open source (licence Apache-2.0) pour les avocats. Sur votre ordinateur, il remplace les noms et les numéros de vos clients par des codes avant que le texte parte vers Claude. Quand Claude répond, Shield remet les vrais noms, toujours sur votre ordinateur. C'est une pseudonymisation locale et réversible.

Tout masquer est facile, mais Claude ne peut plus travailler. Shield masque les données de vos clients et garde le droit lisible : les articles, les juridictions, les dates et les montants restent en clair.

Rien ne part chez RAGbase. Shield n'envoie aucune statistique d'usage.

Essayez-le dans votre navigateur, sans rien installer : https://shield.ragbase.ai

English version below.

Ce que Shield fait pour vous

Vous écrivez ou vous ouvrez ce texte (exemple inventé) :

M. Thibault Mercadier, domicilié 12 rue des Glycines, 69007 Lyon, conteste son
licenciement par la société Ateliers Brunelac SAS, notifié le 3 mars 2025.
Il réclame 48 000 € devant le conseil de prud'hommes de Lyon (RG n° 25/01234).
Contact : t.mercadier@example.org

Claude reçoit ce texte (sortie réelle de Shield 0.4.0) :

M. PERSONNE_A, domicilié ADRESSE_1, conteste son
licenciement par la société SOCIETE_A SAS, notifié le 3 mars 2025.
Il réclame 48 000 € devant le conseil de prud'hommes de Lyon (RG n° RG_1).
Contact : EMAIL_1
  • Claude garde ce qu'il lui faut pour travailler. La date, le montant et la juridiction restent lisibles. Shield est fait pour laisser en clair les juridictions, les institutions, les lois, les codes et les articles.
  • Une personne, un code. Dans un même dossier, « M. Mercadier », « Thibault Mercadier » et « MERCADIER Thibault » deviennent tous PERSONNE_A.
  • Claude lit vos pièces déjà masquées. Vous connectez le dossier du client une fois. Shield lit les PDF avec texte et les fichiers DOCX, XLSX, TXT, MD, EML et HTML.
  • Les vrais noms reviennent chez vous. Shield écrit le document final, avec les vrais noms, sur votre ordinateur. Claude ne peut pas demander les vrais noms à Shield.
  • Le masquage se fait sur votre ordinateur. La table des codes est chiffrée et ne quitte pas votre poste.

Shield se branche sur Claude Desktop, Claude Code et Cowork. Il marche aussi avec ChatGPT desktop, Codex et GitHub Copilot dans VS Code. Pour toute autre application (Microsoft 365 Copilot, Word, Outlook, claude.ai, chatgpt.com), passez par Shield Desk, une page locale sur votre ordinateur : vous masquez, vous copiez dans l'IA, puis vous restaurez la réponse.

Dans cette version

La 0.4.0 est la première version publique de Shield.

  • Installateurs pour Mac (.pkg) et Windows (.msi). Un seul fichier, sans Terminal, prévu sans mot de passe administrateur. Shield et sa propre copie de Python vont dans votre dossier personnel. Shield Desk démarre à chaque ouverture de session, avec une icône dans la barre des menus (Mac) ou dans la zone de notification (Windows).
  • Extension pour Claude Desktop (.mcpb). Un fichier à ouvrir, puis « Installer ».
  • Plugin pour Claude Code et Cowork. Il ajoute des contrôles automatiques (hooks) : une demande qui contient un nom enregistré est bloquée, et la lecture directe d'un dossier enregistré est refusée. Sous Windows, ces contrôles lisent les commandes Git Bash, cmd.exe et PowerShell.
  • Extension de navigateur pour Chrome et Edge. Elle masque le texte que vous collez sur claude.ai et sur les autres sites d'IA.
  • Fichiers Excel (.xlsx). Shield les lit : chaque ligne du classeur devient une ligne de texte. Un fichier abîmé est refusé, pas lu en partie.
  • Tableaux des PDF. Shield lit chaque cellule d'un tableau avec bordures comme une seule cellule, même quand le texte passe sur plusieurs lignes.
  • Français et anglais. Shield détecte la langue de chaque texte. En anglais, il reconnaît les noms dans les messages de chat et les noms de sociétés écrits comme un domaine d'e-mail, et il laisse en clair les mots courants.
  • Deux modes. Rapide (par défaut) : Shield travaille avec ses règles et ses dictionnaires, et répond tout de suite. Précis (avec modèle IA) : un modèle local, GLiNER, ajoute les noms sans titre ni prénom connu, les sociétés sans forme juridique, les pseudonymes et les matricules. Il tourne sur votre ordinateur, hors ligne.
  • Codes ou noms fictifs. Par défaut, Shield remplace les noms par des codes (PERSONNE_A). En option, il les remplace par des noms fictifs réalistes (ragbase-shield set DOSSIER_n --replacement synthetic).
  • Option, désactivée par défaut : masquer votre propre société quand elle est le domaine d'e-mail principal du dossier (RAGBASE_SHIELD_OWN_COMPANY_VENDOR).

Détail : CHANGELOG.md.

Quel fichier télécharger

Votre ordinateur ou votre application Fichier
Mac, macOS 13 ou plus récent (Intel ou puce Apple) RAGbase-Shield-0.4.0.pkg
Mac, si vous connaissez votre modèle (fichier deux fois plus petit) RAGbase-Shield-0.4.0-arm64.pkg (puce Apple, M1 et suivantes) ou RAGbase-Shield-0.4.0-x86_64.pkg (Intel)
Windows 10 ou 11, 64 bits RAGbase-Shield-0.4.0-win64.msi
Claude Desktop (Mac ou Windows) ragbase-shield-0.4.0.mcpb
Chrome ou Edge (claude.ai, chatgpt.com, Copilot web, Gemini) ragbase-shield-browser-extension-0.4.0.zip
Linux, ou tout ordinateur avec Python (pip ou uv) rien à télécharger : pip install ragbase-shield ou uvx ragbase-shield desk
Vérifier un fichier SHA256SUMS

Installer

Mac : le fichier .pkg (étapes de macOS 15)

macOS demande une confirmation la première fois.

  1. Téléchargez RAGbase-Shield-0.4.0.pkg sur cette page.
  2. Double-cliquez sur le fichier. macOS indique qu'il n'a pas pu vérifier le fichier et ne l'ouvre pas. Cliquez sur « Terminé ». Ne cliquez pas sur « Placer dans la corbeille ».
  3. Ouvrez le menu Pomme > Réglages Système > Confidentialité et sécurité. Faites défiler jusqu'à « Sécurité ». Près du message sur RAGbase-Shield-0.4.0.pkg, cliquez sur « Ouvrir quand même ». Ce bouton reste disponible environ une heure après l'étape 2.
  4. macOS vous demande de confirmer : cliquez de nouveau sur « Ouvrir quand même » et saisissez le mot de passe de votre Mac (ou utilisez Touch ID).
  5. Le programme d'installation s'ouvre. Cliquez sur « Continuer », acceptez la licence, puis cliquez sur « Installer ». Si une question porte sur l'emplacement, choisissez « Installer pour moi uniquement ». Le programme ne doit pas demander de mot de passe administrateur : s'il en demande un, arrêtez et écrivez-nous (lien « Issues » plus bas).
  6. Cliquez sur « Fermer ». L'icône bouclier apparaît dans la barre des menus. macOS peut signaler un nouvel élément d'arrière-plan « RAGbase Shield » : c'est normal.
  7. Cliquez sur l'icône, puis sur « Ouvrir Shield Desk », et ajoutez votre premier dossier.

Windows : le fichier .msi

Windows SmartScreen demande une confirmation.

  1. Téléchargez RAGbase-Shield-0.4.0-win64.msi sur cette page. Si le navigateur indique que ce fichier n'est pas couramment téléchargé, gardez-le (Edge : « ... », « Conserver », puis « Afficher plus » et « Conserver quand même »).
  2. Double-cliquez sur le fichier. Windows affiche « Windows a protégé votre ordinateur ». Cliquez sur « Informations complémentaires ». La fenêtre montre « Éditeur : Éditeur inconnu ». Cliquez sur « Exécuter quand même ». Si Windows affiche ensuite « Ouvrir un fichier - Avertissement de sécurité », cliquez sur « Exécuter ». Si le bouton « Exécuter quand même » n'apparaît pas : sur certains PC Windows 11, le Contrôle intelligent des applications (Smart App Control) est actif et bloque les installateurs non signés, sans bouton pour continuer. Utilisez alors la méthode Python avec uv (plus bas) ou attendez l'installateur signé. Ne désactivez pas cette protection. Dans un cabinet, une règle du service informatique peut aussi bloquer le fichier : contactez-le.
  3. L'installation se fait pour votre compte seulement. Elle est prévue sans mot de passe administrateur. Une petite fenêtre de progression s'ouvre, puis se ferme seule.
  4. L'icône bouclier apparaît dans la zone de notification, près de l'horloge (sinon, cliquez sur la flèche ^). Clic droit sur l'icône, puis « Ouvrir Shield Desk ».

Claude Desktop : le fichier .mcpb

Claude Desktop peut afficher un avertissement sur une extension non vérifiée.

  1. Téléchargez ragbase-shield-0.4.0.mcpb.
  2. Double-cliquez sur le fichier (ou glissez-le dans la fenêtre de Claude Desktop), vérifiez les informations, puis cliquez sur « Installer ».
  3. Connectez un dossier une fois dans Shield Desk. Ne joignez pas les fichiers au chat et ne collez pas de texte client brut : ce contenu part chez le fournisseur avant que Shield puisse agir.

Chrome ou Edge : l'extension

En attendant les boutiques Chrome et Edge, chargez l'extension à la main :

  1. Décompressez ragbase-shield-browser-extension-0.4.0.zip dans un dossier.
  2. Ouvrez chrome://extensions (Chrome) ou edge://extensions (Edge) et activez le mode développeur.
  3. Cliquez sur « Charger l'extension non empaquetée » (Chrome) ou « Charger l'extension décompressée » (Edge) et choisissez ce dossier.
  4. Dans la page d'options, collez le jeton de Shield Desk, puis cliquez sur « Tester la connexion ».

Permissions : storage (le jeton, le port, le dossier choisi, dans ce navigateur), sidePanel (le panneau où vous restaurez les noms) et http://127.0.0.1 (Shield Desk sur votre ordinateur, le seul serveur contacté). Le script de l'extension tourne seulement sur chatgpt.com, claude.ai, copilot.microsoft.com, m365.cloud.microsoft et gemini.google.com.

Claude Code et Cowork, Python, et les autres applications

  • Claude Code et Cowork : /plugin marketplace add ragbase/ragbase-shield, puis /plugin install ragbase-shield@ragbase.
  • Python : uvx ragbase-shield desk (avec uv) ou pip install ragbase-shield, puis ragbase-shield desk.
  • ChatGPT desktop, Codex, Copilot dans VS Code : uvx ragbase-shield install chatgpt (ou codex, vscode).
  • Mode Précis (avec modèle IA), en option : uv pip install "ragbase-shield[ner]", puis ragbase-shield ner download, une fois. Ensuite, Shield utilise le modèle.

Guide complet, application par application : docs/INSTALL.md.

Vérifier un fichier avec SHA256SUMS

Comparez l'empreinte SHA-256 du fichier téléchargé avec sa ligne dans SHA256SUMS, avant de l'ouvrir.

  • Mac : ouvrez Terminal dans le dossier de téléchargement, puis tapez shasum -a 256 RAGbase-Shield-0.4.0.pkg.
  • Windows : ouvrez PowerShell dans le dossier de téléchargement, puis tapez Get-FileHash .\RAGbase-Shield-0.4.0-win64.msi -Algorithm SHA256.
  • Tous les fichiers d'un coup (Mac, Linux) : shasum -a 256 -c SHA256SUMS.

Les deux empreintes doivent être identiques (Windows les écrit en majuscules). Si elles diffèrent, n'ouvrez pas le fichier.

6bc10cbb7eea5d410ffe569068400a112bba27705202d9748b1a5e972a653e76  RAGbase-Shield-0.4.0.pkg
0b9dd70bce5e8d60a6c7d003ca06cba11f515bcb7c1a576ce4dfe6ddaef1d68a  RAGbase-Shield-0.4.0-arm64.pkg
a42cb9b1d74b9c5fdcd66faec167d90f5fea94f9d813853d4e099059d622aee9  RAGbase-Shield-0.4.0-x86_64.pkg
69839e85180df4bacf7034da93aedec60e1259356d3146e8ea3bc551b7db1a0a  RAGbase-Shield-0.4.0-win64.msi
c6d976f51f1f730bf2fbec1e904a8662f887aed809963692e73291673459b451  ragbase-shield-0.4.0.mcpb
9b7b2e7b85c9d4bf0d5004f603bcef8c7f916eb3162de6a44e032bdc016cdc6b  ragbase-shield-browser-extension-0.4.0.zip
12d5adb42e3d8d690263a4eb78aa99b1b6f038abd2593d20e9946b5ec17189e0  ragbase_shield-0.4.0-py3-none-any.whl
0e6bc88cc34b20b3dc740d9eaa7a99bc685bc275f131b44b08d62bde775eeca1  ragbase_shield-0.4.0.tar.gz

Résultats : masquer les données, garder le droit

Un outil qui masque tout ne laisse rien fuir, mais Claude ne peut plus rien faire du document. Le bon outil masque les données de vos clients et laisse le droit intact. C'est ce que mesure le score global (F1) : il baisse quand un outil laisse des données lisibles, et aussi quand il masque du texte à tort.

Nous avons comparé Shield 0.4.0, Hexagone 0.3.9 et Presidio 2.2.364 sur quatre benchmarks en français : deux publics (FR-PII-Bench, MAPA) et deux construits par RAGbase (REF, Max). Chaque outil reçoit les mêmes fichiers, sur la même machine. Le même programme note toutes les sorties.

  • Le score global le plus haut. Shield a le score global le plus haut sur les quatre benchmarks : 96,9 sur FR-PII-Bench, 82,2 sur MAPA, 97,1 sur REF et 95,3 sur Max. Hexagone obtient entre 37,9 et 80,7.
  • Le droit reste lisible. Shield modifie de 0 à 4,2 % des termes juridiques (articles, juridictions, lois). Hexagone en modifie de 17,8 à 58,3 %, Presidio de 15,3 à 55,6 %.
  • Une réponse immédiate. En mode Rapide (par défaut), Shield traite un document de 10 pages en 0,59 s et utilise 74 à 75 Mo de mémoire. Hexagone met 26,93 s en mode Rapide et 9 min en mode Précis.
Mesure Benchmark Shield Rapide (par défaut) Shield Précis (avec modèle IA) Hexagone Rapide Hexagone Précis Presidio
Score global (F1), plus haut = mieux FR-PII-Bench (public, textes français) 96,9 96,2 80,7 80,7 66,5
MAPA (public, Cour de cassation) 80,4 82,2 43,8 37,9 63,5
REF (RAGbase, droit du travail) 97,1 97,1 66,7 61,1 79,2
Max (RAGbase, dossiers d'avocat) 95,3 91,8 54,0 48,9 47,4
Termes juridiques modifiés, plus bas = mieux MAPA 0,0 % 0,0 % 43,1 % 47,6 % 18,0 %
REF 4,1 % 4,1 % 17,8 % 47,1 % 15,3 %
Max 2,1 % 4,2 % 47,2 % 58,3 % 55,6 %
Vitesse et mémoire, plus bas = mieux Temps par document de 10 pages 0,59 s 17,4 s 26,93 s 9 min 1,59 s
Mémoire 74 à 75 Mo 3,8 Go 1,6 à 1,7 Go 3,8 à 5,4 Go 0,57 Go

En gras : le score global le plus haut de chaque ligne ; ailleurs, la valeur la plus basse. Le score global est le F1, calculé par mot. Machine de test : 6 cœurs, 16 Go, sans carte graphique.

Tous les résultats et la méthode : https://shield.ragbase.ai/resultats/

La méthode, les scripts et les résultats détaillés sont publics sur GitHub : evaluation/laptop/RESULTS_PUBLIC.md (en anglais).

Les limites connues

  • Relisez le texte masqué avant de l'envoyer. La détection n'est jamais complète : un nom rare, un nom étranger, un surnom ou une faute de frappe peut passer. Enregistrez les parties de chaque dossier.
  • Ce n'est pas une anonymisation. Les faits, les dates et les montants restent lisibles par Claude. Un fait peut identifier un client, même sans son nom.
  • Shield protège seulement ce qui passe par lui. Un fichier joint au chat, ou un texte collé tel quel, part sans masque. Un texte déjà envoyé ne peut pas être rappelé.
  • Les PDF scannés ne sont pas lus. Shield le signale.
  • Les noms restaurés suivent l'orthographe enregistrée dans le dossier. Relisez le document restauré.
  • Les installateurs et l'extension Claude Desktop ne sont pas encore signés. macOS et Windows affichent donc un avertissement à l'installation, et Claude Desktop peut en afficher un. Les étapes ci-dessus montrent comment continuer. Les installateurs signés arrivent dans une prochaine version.
  • L'extension de navigateur n'est pas encore dans les boutiques Chrome et Edge. Elle masque le texte collé ou glissé, pas le texte tapé au clavier. Avant d'envoyer, vérifiez que le texte collé contient bien des codes.
  • Le mode Précis s'installe à part, avec uv. Les installateurs Mac et Windows ne le proposent pas encore. Il utilise plus de mémoire que le mode Rapide.
  • Shield n'est pas une garantie de conformité. Il réduit ce que le fournisseur d'IA reçoit. Des données pseudonymisées restent des données personnelles : le RGPD s'applique toujours.

Liens


RAGbase Shield 0.4.0 (English)

Use Claude on your client files. Shield masks your clients' data before the text is sent.

The best pseudonymisation engine on the market.

RAGbase Shield is a free, open-source tool (Apache-2.0) for lawyers. On your own computer, it replaces your clients' names and numbers with codes before the text goes to Claude. When Claude answers, Shield puts the real names back, also on your computer. This is local, reversible pseudonymisation.

Masking everything is easy, but then Claude cannot do the work. Shield masks your clients' data and keeps the law readable: articles, courts, dates and amounts stay in clear.

Nothing goes to RAGbase. Shield sends no usage statistics.

Try it in your browser, with nothing to install: https://shield.ragbase.ai/en/

What Shield does for you

You write or open this text (invented example, in French):

M. Thibault Mercadier, domicilié 12 rue des Glycines, 69007 Lyon, conteste son
licenciement par la société Ateliers Brunelac SAS, notifié le 3 mars 2025.
Il réclame 48 000 € devant le conseil de prud'hommes de Lyon (RG n° 25/01234).
Contact : t.mercadier@example.org

Claude receives this text (real output of Shield 0.4.0):

M. PERSONNE_A, domicilié ADRESSE_1, conteste son
licenciement par la société SOCIETE_A SAS, notifié le 3 mars 2025.
Il réclame 48 000 € devant le conseil de prud'hommes de Lyon (RG n° RG_1).
Contact : EMAIL_1
  • Claude keeps what it needs to do the work. The date, the amount and the court stay readable. Shield is built to leave courts, institutions, laws, codes and articles in clear.
  • One person, one code. Inside one dossier, "M. Mercadier", "Thibault Mercadier" and "MERCADIER Thibault" all become PERSONNE_A. With English labels, the codes read PERSON_A, COMPANY_A, ADDRESS_1.
  • Claude reads your documents already masked. You connect the client's case folder once. Shield reads PDFs with text and DOCX, XLSX, TXT, MD, EML and HTML files.
  • The real names come back on your computer. Shield writes the final document, with the real names, on your computer. Claude cannot ask Shield for the real names.
  • Masking runs on your computer. The table of codes is encrypted and never leaves your computer.

Shield plugs into Claude Desktop, Claude Code and Cowork. It also works with ChatGPT desktop, Codex and GitHub Copilot in VS Code. For any other app (Microsoft 365 Copilot, Word, Outlook, claude.ai, chatgpt.com), use Shield Desk, a local page on your computer: you mask, you copy into the AI, then you restore the answer.

In this release

0.4.0 is the first public release of Shield.

  • Installers for Mac (.pkg) and Windows (.msi). One file, no Terminal, designed to need no administrator password. Shield and its own copy of Python go into your user folder. Shield Desk starts at each login, with an icon in the menu bar (Mac) or in the notification area (Windows).
  • Extension for Claude Desktop (.mcpb). Open one file, then click "Install".
  • Plugin for Claude Code and Cowork. It adds automatic checks (hooks): a prompt that contains a registered name is blocked, and a direct read of a registered case folder is denied. On Windows, these checks read Git Bash, cmd.exe and PowerShell commands.
  • Browser extension for Chrome and Edge. It masks the text you paste on claude.ai and on the other AI sites.
  • Excel files (.xlsx). Shield reads them: each row of the workbook becomes one line of text. A broken file is refused, not read in part.
  • PDF tables. Shield reads each cell of a table with borders as one cell, also when the text wraps over several lines.
  • French and English. Shield detects the language of each text. In English, it recognises names in chat messages and company names written like an e-mail domain, and it leaves common words in clear.
  • Two modes. Fast (default): Shield works with its rules and dictionaries, and answers at once. Precise (with AI model): a local model, GLiNER, adds the names without a title or a known first name, the companies without a legal form, the usernames and the employee ids. It runs on your computer, offline.
  • Codes or realistic fictional names. By default, Shield replaces names with codes (PERSONNE_A). As an option, it replaces them with realistic fictional names (ragbase-shield set DOSSIER_n --replacement synthetic).
  • Option, off by default: mask your own company when it is the main e-mail domain of the dossier (RAGBASE_SHIELD_OWN_COMPANY_VENDOR).

Detail: CHANGELOG.md.

Which file to download

Your computer or app File
Mac, macOS 13 or later (Intel or Apple chip) RAGbase-Shield-0.4.0.pkg
Mac, if you know your model (half the size) RAGbase-Shield-0.4.0-arm64.pkg (Apple chip, M1 and later) or RAGbase-Shield-0.4.0-x86_64.pkg (Intel)
Windows 10 or 11, 64-bit RAGbase-Shield-0.4.0-win64.msi
Claude Desktop (Mac or Windows) ragbase-shield-0.4.0.mcpb
Chrome or Edge (claude.ai, chatgpt.com, Copilot web, Gemini) ragbase-shield-browser-extension-0.4.0.zip
Linux, or any computer with Python (pip or uv) nothing to download: pip install ragbase-shield or uvx ragbase-shield desk
Check a file SHA256SUMS

Install

Mac: the .pkg file (macOS 15 steps)

macOS asks you to confirm the first time.

  1. Download RAGbase-Shield-0.4.0.pkg from this page.
  2. Double-click the file. macOS says that it could not verify the file and does not open it. Click "Done". Do not click "Move to Trash".
  3. Open the Apple menu > System Settings > Privacy & Security. Scroll down to "Security". Next to the message about RAGbase-Shield-0.4.0.pkg, click "Open Anyway". This button stays for about one hour after step 2.
  4. macOS asks you to confirm: click "Open Anyway" again and enter your Mac password (or use Touch ID).
  5. The installer opens. Click "Continue", accept the licence, then click "Install". If it asks where to install, choose "Install for me only". It must not ask for an administrator password: if it does, stop and tell us (the "Issues" link below).
  6. Click "Close". The shield icon appears in the menu bar. macOS can show a new background item "RAGbase Shield": this is normal.
  7. Click the icon, then "Open Shield Desk", and add your first dossier.

Windows: the .msi file

Windows SmartScreen asks you to confirm.

  1. Download RAGbase-Shield-0.4.0-win64.msi from this page. If the browser says that this file is not commonly downloaded, keep it (Edge: "...", "Keep", then "Show more" and "Keep anyway").
  2. Double-click the file. Windows shows "Windows protected your PC". Click "More info". The window shows "Publisher: Unknown publisher". Click "Run anyway". If Windows then shows "Open File - Security Warning", click "Run". If the "Run anyway" button does not appear: on some Windows 11 PCs, Smart App Control is on and blocks unsigned installers, with no button to continue. Then use the Python method with uv (below) or wait for the signed installer. Do not turn this protection off. In a firm, an IT rule can also block the file: contact your IT team.
  3. The install is for your account only. It is designed to need no administrator password. A small progress window opens, then closes by itself.
  4. The shield icon appears in the notification area, near the clock (if not, click the ^ arrow). Right-click the icon, then "Open Shield Desk".

Claude Desktop: the .mcpb file

Claude Desktop can show a warning about an unverified extension.

  1. Download ragbase-shield-0.4.0.mcpb.
  2. Double-click the file (or drag it into the Claude Desktop window), review the details, then click "Install".
  3. Connect a folder once in Shield Desk. Do not attach files to the chat and do not paste raw client text: that content reaches the provider before Shield can act.

Chrome or Edge: the extension

Until the extension is in the Chrome and Edge stores, load it by hand:

  1. Unzip ragbase-shield-browser-extension-0.4.0.zip into a folder.
  2. Open chrome://extensions (Chrome) or edge://extensions (Edge) and turn on developer mode.
  3. Click "Load unpacked" and choose that folder.
  4. On the options page, paste the Shield Desk token, then click "Test the connection".

Permissions: storage (the token, the port and the chosen dossier, in this browser), sidePanel (the panel where you restore the names) and http://127.0.0.1 (Shield Desk on your computer, the only server it contacts). The extension's script runs only on chatgpt.com, claude.ai, copilot.microsoft.com, m365.cloud.microsoft and gemini.google.com.

Claude Code and Cowork, Python, and the other apps

  • Claude Code and Cowork: /plugin marketplace add ragbase/ragbase-shield, then /plugin install ragbase-shield@ragbase.
  • Python: uvx ragbase-shield desk (with uv) or pip install ragbase-shield, then ragbase-shield desk.
  • ChatGPT desktop, Codex, Copilot in VS Code: uvx ragbase-shield install chatgpt (or codex, vscode).
  • Precise mode (with AI model), optional: uv pip install "ragbase-shield[ner]", then ragbase-shield ner download, once. After that, Shield uses the model.

Full guide, app by app: docs/INSTALL.md.

Check a file with SHA256SUMS

Compare the SHA-256 of the downloaded file with its line in SHA256SUMS before you open it.

  • Mac: open Terminal in the download folder, then type shasum -a 256 RAGbase-Shield-0.4.0.pkg.
  • Windows: open PowerShell in the download folder, then type Get-FileHash .\RAGbase-Shield-0.4.0-win64.msi -Algorithm SHA256.
  • All files at once (Mac, Linux): shasum -a 256 -c SHA256SUMS.

The two values must be the same (Windows writes them in capital letters). If they are not the same, do not open the file.

6bc10cbb7eea5d410ffe569068400a112bba27705202d9748b1a5e972a653e76  RAGbase-Shield-0.4.0.pkg
0b9dd70bce5e8d60a6c7d003ca06cba11f515bcb7c1a576ce4dfe6ddaef1d68a  RAGbase-Shield-0.4.0-arm64.pkg
a42cb9b1d74b9c5fdcd66faec167d90f5fea94f9d813853d4e099059d622aee9  RAGbase-Shield-0.4.0-x86_64.pkg
69839e85180df4bacf7034da93aedec60e1259356d3146e8ea3bc551b7db1a0a  RAGbase-Shield-0.4.0-win64.msi
c6d976f51f1f730bf2fbec1e904a8662f887aed809963692e73291673459b451  ragbase-shield-0.4.0.mcpb
9b7b2e7b85c9d4bf0d5004f603bcef8c7f916eb3162de6a44e032bdc016cdc6b  ragbase-shield-browser-extension-0.4.0.zip
12d5adb42e3d8d690263a4eb78aa99b1b6f038abd2593d20e9946b5ec17189e0  ragbase_shield-0.4.0-py3-none-any.whl
0e6bc88cc34b20b3dc740d9eaa7a99bc685bc275f131b44b08d62bde775eeca1  ragbase_shield-0.4.0.tar.gz

Results: mask the data, keep the law

A tool that masks everything leaks nothing, but Claude can do nothing with the document. The right tool masks your clients' data and leaves the law intact. The overall score (F1) measures exactly that: it drops when a tool leaves data readable, and also when it masks text by mistake.

We compared Shield 0.4.0, Hexagone 0.3.9 and Presidio 2.2.364 on four benchmarks in French: two public (FR-PII-Bench, MAPA) and two built by RAGbase (REF, Max). Each tool gets the same files, on the same machine. The same program scores every output.

  • The highest overall score. Shield has the highest overall score on the four benchmarks: 96.9 on FR-PII-Bench, 82.2 on MAPA, 97.1 on REF and 95.3 on Max. Hexagone scores between 37.9 and 80.7.
  • The law stays readable. Shield changes 0 to 4.2% of the legal terms (articles, courts, laws). Hexagone changes 17.8 to 58.3%, Presidio 15.3 to 55.6%.
  • An immediate answer. In Fast mode (the default), Shield handles a 10-page document in 0.59 s and uses 74 to 75 MB of memory. Hexagone takes 26.93 s in Fast mode and 9 min in Precis mode.
Measure Benchmark Shield Fast (default) Shield Precise (with AI model) Hexagone Fast Hexagone Precis Presidio
Overall score (F1), higher is better FR-PII-Bench (public, French texts) 96.9 96.2 80.7 80.7 66.5
MAPA (public, Cour de cassation) 80.4 82.2 43.8 37.9 63.5
REF (RAGbase, employment law) 97.1 97.1 66.7 61.1 79.2
Max (RAGbase, law-firm files) 95.3 91.8 54.0 48.9 47.4
Legal terms changed, lower is better MAPA 0.0% 0.0% 43.1% 47.6% 18.0%
REF 4.1% 4.1% 17.8% 47.1% 15.3%
Max 2.1% 4.2% 47.2% 58.3% 55.6%
Speed and memory, lower is better Time per 10-page document 0.59 s 17.4 s 26.93 s 9 min 1.59 s
Memory 74 to 75 MB 3.8 GB 1.6 to 1.7 GB 3.8 to 5.4 GB 0.57 GB

Bold: the highest overall score in each row; elsewhere, the lowest value. The overall score is the F1, computed by word. Test machine: 6 cores, 16 GB, no graphics card.

All the results and the method: https://shield.ragbase.ai/en/results/

The method, the scripts and the detailed results are public on GitHub: evaluation/laptop/RESULTS_PUBLIC.md.

Known limits

  • Read the masked text before you send it. Detection is never complete: a rare name, a foreign name, a nickname or a typo can slip through. Register the parties of each dossier.
  • This is not anonymisation. Facts, dates and amounts stay readable by Claude. A fact can identify a client, even without a name.
  • Shield protects only what goes through it. A file attached to the chat, or text pasted as it is, goes out unmasked. Text already sent cannot be recalled.
  • Scanned PDFs are not read. Shield tells you so.
  • Restored names use the spelling stored in the dossier. Re-read the restored document.
  • The installers and the Claude Desktop extension are not code-signed yet. So macOS and Windows show a warning at install, and Claude Desktop can show one. The steps above show how to continue. Signed installers will come in a later version.
  • The browser extension is not in the Chrome and Edge stores yet. It masks text you paste or drop, not text you type. Before you send, check that the pasted text shows codes.
  • Precise mode is a separate install, with uv. The Mac and Windows installers do not offer it yet. It uses more memory than Fast mode.
  • Shield is not a compliance guarantee. It reduces what the AI provider receives. Pseudonymised data are still personal data: the GDPR still applies.

Links