Repository navigation
RAGbase Shield 0.4.1
RAGbase Shield 0.4.1
Utilisez Claude sur vos dossiers clients, sans aucune fuite d'informations sensibles.
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.
Nouveau dans cette version
Les avocats tapent vite, souvent sans majuscules. Shield 0.4.1 masque le nom de votre client, sa société et son adresse dans un texte tapé ainsi, et laisse le texte juridique intact.
Vous tapez (exemple inventé) :
bonjour, m. thibault mercadier, domicilié 12 rue des glycines, 69007 lyon, conteste son licenciement par la société ateliers brunelac sas.
que peut-il demander devant le conseil de prud'hommes sur le fondement de l'article l. 1235-3 du code du travail ?
Claude reçoit (sortie réelle de Shield 0.4.1) :
bonjour, m. PERSONNE_A, domicilié ADRESSE_1, conteste son licenciement par la société SOCIETE_A sas.
que peut-il demander devant le conseil de prud'hommes sur le fondement de l'article l. 1235-3 du code du travail ?
Après « M. », « Mme », « Mlle » ou « Me », Shield masque le nom qui suit, avec ou sans majuscules, dans tous les textes en français. Dans un texte tapé sans majuscules, comme sur un téléphone ou dans une note rapide, Shield masque aussi les noms avec ou sans civilité, les sociétés écrites avec leur forme juridique, les adresses postales et les champs « nom : » et « prénom : ». Le réglage RAGBASE_SHIELD_LOWERCASE_NAMES=0 désactive ces règles.
Le texte juridique d'un document n'est pas touché.
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.1) :
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.
Aussi dans 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.1.pkg |
| Mac, si vous connaissez votre modèle (fichier deux fois plus petit) | RAGbase-Shield-0.4.1-arm64.pkg (puce Apple, M1 et suivantes) ou RAGbase-Shield-0.4.1-x86_64.pkg (Intel) |
| Windows 10 ou 11, 64 bits | RAGbase-Shield-0.4.1-win64.msi |
| Claude Desktop (Mac ou Windows) | ragbase-shield-0.4.1.mcpb |
| Chrome ou Edge (claude.ai, chatgpt.com, Copilot web, Gemini) | ragbase-shield-browser-extension-0.4.1.zip |
| Linux, ou tout ordinateur avec Python (pip ou uv) | ragbase_shield-0.4.1-py3-none-any.whl, avec uv ou pip (commandes ci-dessous) |
| Vérifier un fichier | SHA256SUMS |
Installer
Mac : le fichier .pkg (étapes de macOS 15)
macOS demande une confirmation la première fois.
- Téléchargez
RAGbase-Shield-0.4.1.pkgsur cette page. - 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 ».
- 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.1.pkg, cliquez sur « Ouvrir quand même ». Ce bouton reste disponible environ une heure après l'étape 2. - 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).
- 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).
- 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.
- Cliquez sur l'icône, puis sur « Ouvrir Shield Desk », et ajoutez votre premier dossier.
Windows : le fichier .msi
Windows SmartScreen demande une confirmation.
- Téléchargez
RAGbase-Shield-0.4.1-win64.msisur 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 »). - 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.
- 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.
- 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.
- Téléchargez
ragbase-shield-0.4.1.mcpb. - Double-cliquez sur le fichier (ou glissez-le dans la fenêtre de Claude Desktop), vérifiez les informations, puis cliquez sur « Installer ».
- 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 :
- Décompressez
ragbase-shield-browser-extension-0.4.1.zipdans un dossier. - Ouvrez
chrome://extensions(Chrome) ouedge://extensions(Edge) et activez le mode développeur. - Cliquez sur « Charger l'extension non empaquetée » (Chrome) ou « Charger l'extension décompressée » (Edge) et choisissez ce dossier.
- 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 :
uv tool install https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl(avec uv) oupip install https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl, puisragbase-shield desk. - ChatGPT desktop, Codex, Copilot dans VS Code :
ragbase-shield install chatgpt(oucodex,vscode), une fois la commande installée avec uv (commande plus haut). - Mode Précis (avec modèle IA), en option :
uv tool install --python 3.12 "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl"(avec uv) oupip install "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl", puisragbase-shield ner download, une fois. Ensuite, Shield utilise le modèle. - Sur un Mac avec un processeur Intel, utilisez cette ligne :
uv tool install --python 3.12 --with "numpy<2" --with "sentencepiece<0.2.3" "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl"(avec uv) oupip install "numpy<2" "sentencepiece<0.2.3" "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl".
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.1.pkg. - Windows : ouvrez PowerShell dans le dossier de téléchargement, puis tapez
Get-FileHash .\RAGbase-Shield-0.4.1-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.
620e4b92113d8fd4ca4465cb4412f72c2c034e0915243b17782e49c20af45df8 RAGbase-Shield-0.4.1.pkg
40e579accf70d668dea0787a9cfa2c0627378872a0c58b88346860fa6ec96d95 RAGbase-Shield-0.4.1-arm64.pkg
21ec800b0f3de906e688027edc06058ccd911003db3ae6d28d0464c96c19624e RAGbase-Shield-0.4.1-x86_64.pkg
9e5c45c58e13a7eb8ea52a8a30d92e6da968a4be34a18ec7e7da12b3c547f380 RAGbase-Shield-0.4.1-win64.msi
034642ee81c07f7c4c3bd18e3da84c8b8de6f150815bdad7b6d6503b0e6eefc6 ragbase-shield-0.4.1.mcpb
3e86b69d94ae31d37d6fc8e68ad86bf4fa7776cde488f14a4e53cee9b379ebc7 ragbase-shield-browser-extension-0.4.1.zip
1710644a4e93e3e436f4d46d9d931d98eee208fe6b58d6f82a5f2e455aad54c5 ragbase_shield-0.4.1-py3-none-any.whl
20ee2aa0fb92907705d2ea327508724f241337c52cd98348a662fc9ac3fab54a ragbase_shield-0.4.1.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.1, 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,61 s et utilise 78 à 79 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,61 s | 17,7 s | 26,93 s | 9 min | 1,59 s |
| Mémoire | 78 à 79 Mo | 3,7 à 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
- Page du produit, avec la démo dans le navigateur : https://shield.ragbase.ai
- Installer, pas à pas : https://shield.ragbase.ai/installer/
- Tous les résultats et la méthode : https://shield.ragbase.ai/resultats/
- Limites et conformité : https://shield.ragbase.ai/limites-et-conformite/
- Code source : https://github.com/ragbase/ragbase-shield
- Guide d'installation : https://github.com/ragbase/ragbase-shield/blob/main/docs/INSTALL.md
- Méthode et résultats détaillés (en anglais) : https://github.com/ragbase/ragbase-shield/blob/main/evaluation/laptop/RESULTS_PUBLIC.md
- Modèle de confidentialité : https://github.com/ragbase/ragbase-shield/blob/main/docs/PRIVACY_MODEL.md
- Fiche conformité (ce que disent le RGPD, le CNB et le barreau de Paris) : https://github.com/ragbase/ragbase-shield/blob/main/docs/CONFORMITE.fr.md
- Questions et problèmes : https://github.com/ragbase/ragbase-shield/issues
- Signaler une faille de sécurité : https://github.com/ragbase/ragbase-shield/blob/main/SECURITY.md
RAGbase Shield 0.4.1 (English)
Use Claude on your client files, without leaking any sensitive information.
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/
New in this release
Lawyers type fast, often without capitals. Shield 0.4.1 masks your client's name, company and address in text typed that way, and leaves the legal text intact.
You type (invented example, in French):
bonjour, m. thibault mercadier, domicilié 12 rue des glycines, 69007 lyon, conteste son licenciement par la société ateliers brunelac sas.
que peut-il demander devant le conseil de prud'hommes sur le fondement de l'article l. 1235-3 du code du travail ?
Claude receives (real output of Shield 0.4.1):
bonjour, m. PERSONNE_A, domicilié ADRESSE_1, conteste son licenciement par la société SOCIETE_A sas.
que peut-il demander devant le conseil de prud'hommes sur le fondement de l'article l. 1235-3 du code du travail ?
After "M.", "Mme", "Mlle" or "Me", Shield masks the name that follows, with or without capitals, in every French text. In text typed without capitals, as on a phone or in a quick note, Shield also masks names with or without a title, companies written with their legal form, postal addresses and the fields "nom :" and "prénom :". The setting RAGBASE_SHIELD_LOWERCASE_NAMES=0 turns these rules off.
The legal text of a document is not touched.
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.1):
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.
Also in 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.1.pkg |
| Mac, if you know your model (half the size) | RAGbase-Shield-0.4.1-arm64.pkg (Apple chip, M1 and later) or RAGbase-Shield-0.4.1-x86_64.pkg (Intel) |
| Windows 10 or 11, 64-bit | RAGbase-Shield-0.4.1-win64.msi |
| Claude Desktop (Mac or Windows) | ragbase-shield-0.4.1.mcpb |
| Chrome or Edge (claude.ai, chatgpt.com, Copilot web, Gemini) | ragbase-shield-browser-extension-0.4.1.zip |
| Linux, or any computer with Python (pip or uv) | ragbase_shield-0.4.1-py3-none-any.whl, with uv or pip (commands below) |
| Check a file | SHA256SUMS |
Install
Mac: the .pkg file (macOS 15 steps)
macOS asks you to confirm the first time.
- Download
RAGbase-Shield-0.4.1.pkgfrom this page. - 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".
- Open the Apple menu > System Settings > Privacy & Security. Scroll down to "Security". Next to the message about
RAGbase-Shield-0.4.1.pkg, click "Open Anyway". This button stays for about one hour after step 2. - macOS asks you to confirm: click "Open Anyway" again and enter your Mac password (or use Touch ID).
- 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).
- Click "Close". The shield icon appears in the menu bar. macOS can show a new background item "RAGbase Shield": this is normal.
- Click the icon, then "Open Shield Desk", and add your first dossier.
Windows: the .msi file
Windows SmartScreen asks you to confirm.
- Download
RAGbase-Shield-0.4.1-win64.msifrom this page. If the browser says that this file is not commonly downloaded, keep it (Edge: "...", "Keep", then "Show more" and "Keep anyway"). - 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.
- The install is for your account only. It is designed to need no administrator password. A small progress window opens, then closes by itself.
- 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.
- Download
ragbase-shield-0.4.1.mcpb. - Double-click the file (or drag it into the Claude Desktop window), review the details, then click "Install".
- 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:
- Unzip
ragbase-shield-browser-extension-0.4.1.zipinto a folder. - Open
chrome://extensions(Chrome) oredge://extensions(Edge) and turn on developer mode. - Click "Load unpacked" and choose that folder.
- 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:
uv tool install https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl(with uv) orpip install https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl, thenragbase-shield desk. - ChatGPT desktop, Codex, Copilot in VS Code:
ragbase-shield install chatgpt(orcodex,vscode), once the command is installed with uv (command above). - Precise mode (with AI model), optional:
uv tool install --python 3.12 "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl"(with uv) orpip install "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl", thenragbase-shield ner download, once. After that, Shield uses the model. - On a Mac with an Intel processor, use this line:
uv tool install --python 3.12 --with "numpy<2" --with "sentencepiece<0.2.3" "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl"(with uv) orpip install "numpy<2" "sentencepiece<0.2.3" "ragbase-shield[ner] @ https://github.com/ragbase/ragbase-shield/releases/download/v0.4.1/ragbase_shield-0.4.1-py3-none-any.whl".
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.1.pkg. - Windows: open PowerShell in the download folder, then type
Get-FileHash .\RAGbase-Shield-0.4.1-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.
620e4b92113d8fd4ca4465cb4412f72c2c034e0915243b17782e49c20af45df8 RAGbase-Shield-0.4.1.pkg
40e579accf70d668dea0787a9cfa2c0627378872a0c58b88346860fa6ec96d95 RAGbase-Shield-0.4.1-arm64.pkg
21ec800b0f3de906e688027edc06058ccd911003db3ae6d28d0464c96c19624e RAGbase-Shield-0.4.1-x86_64.pkg
9e5c45c58e13a7eb8ea52a8a30d92e6da968a4be34a18ec7e7da12b3c547f380 RAGbase-Shield-0.4.1-win64.msi
034642ee81c07f7c4c3bd18e3da84c8b8de6f150815bdad7b6d6503b0e6eefc6 ragbase-shield-0.4.1.mcpb
3e86b69d94ae31d37d6fc8e68ad86bf4fa7776cde488f14a4e53cee9b379ebc7 ragbase-shield-browser-extension-0.4.1.zip
1710644a4e93e3e436f4d46d9d931d98eee208fe6b58d6f82a5f2e455aad54c5 ragbase_shield-0.4.1-py3-none-any.whl
20ee2aa0fb92907705d2ea327508724f241337c52cd98348a662fc9ac3fab54a ragbase_shield-0.4.1.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.1, 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.61 s and uses 78 to 79 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.61 s | 17.7 s | 26.93 s | 9 min | 1.59 s |
| Memory | 78 to 79 MB | 3.7 to 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
- Product page, with the demo in your browser: https://shield.ragbase.ai/en/
- Step-by-step install: https://shield.ragbase.ai/en/install/
- All the results and the method: https://shield.ragbase.ai/en/results/
- Limits and compliance: https://shield.ragbase.ai/en/limits-and-compliance/
- Source code: https://github.com/ragbase/ragbase-shield
- Install guide: https://github.com/ragbase/ragbase-shield/blob/main/docs/INSTALL.md
- Method and detailed results: https://github.com/ragbase/ragbase-shield/blob/main/evaluation/laptop/RESULTS_PUBLIC.md
- Privacy model: https://github.com/ragbase/ragbase-shield/blob/main/docs/PRIVACY_MODEL.md
- Questions and problems: https://github.com/ragbase/ragbase-shield/issues
- Report a security issue: https://github.com/ragbase/ragbase-shield/blob/main/SECURITY.md