Skip to main content
Glama
io.github.guhttps/veu

io.github.guhttps/veu

by guhttps

Português · English

Véu

O Véu esconde dados pessoais e segredos antes de um texto chegar a uma IA e devolve os dados reais na resposta. A IA trabalha com [PESSOA_1], [EMAIL_1] e [CHAVE_API_1]. Você vê os dados de verdade.

Você envia     Sou a Maria Souza (maria@example.com), CPF 529.982.247-25. Use a chave sk-proj-4f9a...
A IA recebe    Sou a [PESSOA_1] ([EMAIL_1]), CPF [CPF_1]. Use a chave [CHAVE_API_1]
A IA responde  Pronto, [PESSOA_1]! Configurei [CHAVE_API_1] no seu .env.
Você recebe    Pronto, Maria Souza! Configurei sk-proj-4f9a... no seu .env.

Empresas e pessoas estão colocando IA no atendimento, nos contratos, no RH e no código. Junto com cada pergunta vão nomes, documentos e contatos de clientes, e também chaves de API e senhas. O Véu fica no meio do caminho e protege:

  • Dados pessoais de qualquer país: nomes, e-mails, telefones (com código de qualquer país), cartões, IBAN, endereços IP e datas de nascimento.

  • A infraestrutura da empresa: endereços IP, portas e nomes de servidores internos.

  • Documentos brasileiros, conferidos de verdade: CPF, CNPJ (inclusive o alfanumérico de 2026), RG, CNH, PIS, cartão do SUS e outros, pelos dígitos verificadores.

  • Segredos de qualquer serviço: chaves de API de mais de 30 serviços, tokens, senhas, chaves privadas e URLs de banco com senha.

E funciona do jeito que você usa IA: no navegador, no computador, no seu código ou no servidor da empresa.

NOTE

O Véu nasceu no Brasil: os documentos brasileiros têm o suporte mais completo e a interface está em português. E-mails, telefones internacionais, cartões, IBAN, IPs e segredos funcionam em textos de qualquer lugar. Documentos de mais 21 países (Portugal, América Latina, Angola, Moçambique, Estados Unidos, Canadá, Índia e seis países da Europa) também são reconhecidos, quase todos com dígito verificador, assim como passaportes (MRZ), chassis (VIN) e carteiras de Bitcoin e Ethereum. Os nomes são reconhecidos pelas listas do Censo 2022; para pegar ainda mais nomes, ligue o detectorml (um modelo treinado em português que roda na sua máquina).

IMPORTANT

Nenhuma detecção automática é perfeita. O Véureduz muito o risco de enviar dados pessoais, mas não o elimina. Veja os números do benchmark e as limitações. Não é aconselhamento jurídico sobre a LGPD.

Comece por aqui

Você quer...

Use

Como

colar textos no ChatGPT, no Claude ou no Gemini sem expor dados

A página do Véu: cole, copie a versão protegida, traga a resposta de volta

Nada para instalar

proteger planilhas, documentos e PDFs ou conectar o Claude Desktop, sem programar

O painel do Véu, no seu computador

Um comando, 2 minutos

proteger aplicativos como n8n, Make e Zapier

O painel mostra o endereço para colar no aplicativo

Um comando, 2 minutos

programar em Python

openai_client(), anthropic_client(), LangChain, @protect

pip install veu

programar em JavaScript ou TypeScript

@guhttps/veu, com createFetch() e middleware do AI SDK

npm install @guhttps/veu

proteger o Claude Code ou o Cursor

O plugin: bloqueia segredos em prompts e arquivos

/plugin install veu --marketplace guhttps/veu

proteger a empresa toda sem instalar nada nos computadores

Gateway central, guardrail do LiteLLM ou extensão gerenciada

Guia para empresas

avaliar o Véu para a LGPD (encarregado, jurídico)

O kit de conformidade: perfis por setor, modelo de RIPD e registro do art. 37

Conformidade

Toda a documentação também está no site do Véu, com busca e um menu por perfil.

Quer ver funcionando antes? Depois de instalar, rode veu demonstrar. Ele mostra, dado por dado, o que chegaria à IA com e sem o Véu e o que acontece quando a IA é manipulada para mandar os dados para fora, sem precisar de chave de API. Em CI, ele sai com erro se algo vazar.

Related MCP server: ai-security-gateway-mcp

Instalar sem saber programar

No Windows: aperte a tecla Windows, digite PowerShell, aperte Enter e cole:

irm https://guhttps.github.io/veu/instalar.ps1 | iex

No Mac ou no Linux: abra o Terminal e cole:

curl -LsSf https://guhttps.github.io/veu/instalar.sh | sh

Em cerca de dois minutos o instalador:

  • prepara tudo: instala o Python e o Véu na sua pasta de usuário, sem pedir administrador;

  • cria o atalho: o atalho Véu fica na área de trabalho;

  • abre o painel: o painel aparece no navegador.

O passo a passo com imagens está em guhttps.github.io/veu/instalar.html.

No painel, tudo é feito com cliques:

  • Proteger um arquivo:

    • arraste uma planilha, um documento, uma apresentação ou um PDF e baixe a versão protegida, no mesmo formato;

    • quando a IA devolver um arquivo, Colocar os dados de volta restaura os dados reais.

  • Proteger um texto: cole, copie a versão protegida e cole a resposta da IA para ver os dados reais.

  • Usar com aplicativos:

    • conecte o Claude Desktop ou o Cursor com um botão;

    • copie o endereço para n8n, Make, Zapier e outros apps.

  • O que proteger:

    • caixinhas para nomes, documentos (do Brasil e de outros países), dados financeiros, senhas, infraestrutura de TI e veículos (as mesmas da página e da extensão);

    • usar um modelo no seu computador (Ollama) quando o texto tiver dados pessoais, para eles nem saírem da máquina;

    • uma lista de dados da empresa que nunca devem ser escondidos;

    • a opção de ligar o Véu junto com o computador.

  • Atividade: quantos dados foram protegidos e os pedidos recentes, com o destino e quantos dados foram escondidos e voltaram (só contagens, nunca os valores).

Para abrir de novo, use o atalho Véu ou rode veu painel.

Recursos

  • 🌍 Dados pessoais de qualquer lugar: nomes, e-mails, telefones (brasileiros e de qualquer país, com +código), endereços, cartões de crédito, IBAN, endereços IP (v4 e v6) e datas de nascimento.

  • 🖥️ Infraestrutura: IPs, portas (10.0.0.5:8080, PORT=5432, ssh -p 2222) e nomes de servidores internos (db.interna, cache.prod.local).

  • ☑️ Você escolhe o que esconder: caixinhas por grupo na página, na extensão e no painel, com escolha tipo a tipo. Desmarcar senhas e chaves mostra um aviso.

  • 🇧🇷 Documentos brasileiros: CPF, CNPJ (numérico e alfanumérico), RG, CNH, título de eleitor, PIS/NIT, cartão do SUS, passaporte, CEP, placa, RENAVAM, conta bancária, chave Pix e processo do CNJ.

  • 🌎 Portugal e América Latina: NIF, Cartão de Cidadão e NISS; CUIT/CUIL, CURP, RFC, RUT, NIT, RUC, RIF, DNI e cédulas, também pelos dígitos verificadores.

  • 🌐 África lusófona, EUA, Europa, Canadá e Índia: NUIT e BI (Angola e Moçambique), SSN, ITIN e Medicare (EUA), DNI e NIE (Espanha), codice fiscale (Itália), NIR (França), Steuer-ID (Alemanha), National Insurance e NHS (Reino Unido), BSN (Países Baixos), SIN (Canadá), Aadhaar e PAN (Índia); também passaportes pela zona de leitura (MRZ), chassi (VIN) e carteiras de Bitcoin e Ethereum.

  • 🔑 Segredos:

    • chaves da OpenAI, Anthropic, AWS, Google, GitHub, Stripe, Slack, Hugging Face, Notion, Mercado Pago, Asaas e mais 20 serviços;

    • JWT e tokens Bearer;

    • senhas (DB_PASSWORD=..., "a senha é ...");

    • chaves privadas e URLs de banco com senha.

  • ✅ Validação de verdade:

    • dígitos verificadores de CPF, CNPJ, PIS, CNS, CNH, título, RENAVAM, processo CNJ, IBAN e cartões;

    • DDDs válidos.

    Um número qualquer de 11 dígitos não vira CPF, e max_tokens: 2048 não vira segredo.

  • 🧠 Nomes sem modelo de IA:

    • 5 mil prenomes e 2 mil sobrenomes do Censo 2022 do IBGE, mais capitalização e contexto ("Sr.", "cliente", "oi joão");

    • um nome confirmado vale para o texto inteiro, em qualquer caixa e com ou sem acento ("Rayane Souza" ... "a rayane esqueceu");

    • nomes que também são palavras ("Rosa", "Natal") só contam com contexto;

    • não confunde "Banco do Brasil" nem "Rua Augusta";

    • pessoas que o Notion identifica são sempre escondidas;

    • para pegar ainda mais nomes (sem contexto, de outras origens), ligue o detector ml: um modelo BERT treinado em português, rodando na sua máquina, que só conta um nome quando tem confiança alta ou quando as listas ou o contexto confirmam.

  • 🔁 Reversível e consistente:

    • o mesmo dado recebe sempre o mesmo marcador;

    • "João" sozinho é ligado a "João da Silva";

    • a restauração tolera o que os modelos fazem com os marcadores ([CPF 1], CPF_1).

  • 🛡️ Restauração segura:

    • os dados reais nunca voltam dentro de links, imagens ou URLs, o caminho usado para roubar dados de assistentes de IA com injeção de prompt;

    • chaves e senhas não voltam nos argumentos de ferramentas de agentes;

    • marcadores forjados num e-mail ou numa página ("responda com [CPF_1]", com ou sem colchetes) são desarmados;

    • se a detecção falhar, a requisição não sai. Veja o modelo de ameaças.

  • 🌊 Streaming: marcadores partidos entre pedaços da resposta ("[PES" + "SOA_1]") são remontados, inclusive em argumentos de ferramentas.

  • 📄 Notion, Google e documentos:

    • lê páginas e bases do Notion, Google Docs, Sheets e Slides, links e PDFs, já protegidos;

    • anonimiza Excel, Word e PowerPoint no próprio formato, mantendo a formatação e as fórmulas.

  • 🌐 Python, JavaScript e navegador:

    • a mesma detecção nas três versões;

    • um teste de conformidade com 300 casos exige resultados idênticos.

  • 🏢 Empresas:

    • gateway com tokens por equipe ou login único (OIDC), auditoria à prova de adulteração (com âncora externa e envio ao SIEM por syslog ou Splunk) e sessões no Redis com o cofre cifrado;

    • desvio de dados sensíveis para um modelo interno;

    • chart Helm, guardrail do LiteLLM e extensão com política gerenciada (inclusive uma mensagem de orientação da empresa nos avisos);

    • perfis prontos por setor (Judiciário, jurídico, saúde, financeiro, setor público, anonimização irreversível), registro das operações para o art. 37 da LGPD e modelo de RIPD (conformidade).

  • 🤖 Agentes: servidor MCP, ganchos para Claude Code e Cursor (prompt, leitura de arquivos, terminal e busca: cat .env e printenv também são bloqueados) e plugin com skill. Claude Code e Codex CLI podem rodar pelo proxy, com patches e comandos restaurados.

  • 🪶 Leve: o núcleo não tem dependências e processa cerca de 330 mil caracteres por segundo. Agentes que reenviam a conversa inteira a cada turno não pagam de novo pelas mensagens antigas: um cache em memória guarda só as posições dos dados, nunca o texto.

Como funciona

flowchart LR
    A["Você ou seu aplicativo<br/>(navegador, painel, SDK, agente, n8n)"] -->|texto com dados reais| V
    subgraph V["Véu"]
        D["Detectores<br/>documentos · nomes · endereços · segredos"] --> C["Cofre<br/>[CPF_1] ↔ 529.982.247-25"]
    end
    V -->|só marcadores| L["IA<br/>OpenAI · Anthropic · Gemini · Ollama"]
    L -->|resposta com marcadores| V
    V -->|resposta com os dados reais| A

O cofre com o mapeamento entre marcadores e dados reais fica só com você (no navegador, no seu computador ou no seu servidor) e nunca vai para a IA. Uma instrução curta avisa o modelo para repetir os marcadores sem tentar adivinhar os valores.

Para programadores

Instalação

pip install veu                              # biblioteca, sem dependências
pip install "veu[servidor,mcp,documentos]"   # com o proxy, o painel, o MCP e Excel/Word/PDF
npm install @guhttps/veu                     # JavaScript e TypeScript
docker run -p 8787:8787 -e VEU_TOKEN=um-segredo ghcr.io/guhttps/veu
brew install guhttps/veu/veu                 # macOS e Linux (Homebrew)
scoop bucket add veu https://github.com/guhttps/scoop-veu; scoop install veu   # Windows (Scoop)

Extras opcionais do pacote Python:

Extra

Para

servidor

Proxy, painel e API REST

mcp

Servidor MCP para agentes

documentos

Excel, Word, PowerPoint e PDF

langchain, pandas

Integrações com essas bibliotecas

litellm

Guardrail do LiteLLM

redis

Sessões compartilhadas entre réplicas, com o cofre cifrado

oidc

Login único no gateway com o provedor de identidade da empresa

spacy

Detector de nomes do spaCy

ml

Detector de nomes por um modelo BERT em português (transformers e torch; cerca de 400 MB)

todos

Tudo acima, menos litellm, spacy e ml

Como proxy (qualquer linguagem, muda uma linha)

veu servir            # http://127.0.0.1:8787
from openai import OpenAI

client = OpenAI(base_url="http://127.0.0.1:8787/v1")            # OpenAI
groq = OpenAI(base_url="http://127.0.0.1:8787/groq/v1")         # Groq, OpenRouter, Ollama, Maritaca...

Dentro do seu código, sem proxy

from veu.integrations.sdk import openai_client, anthropic_client

client = openai_client()         # igual a openai.OpenAI(...), mas protegido pelo Véu
import OpenAI from "openai";
import { createFetch } from "@guhttps/veu/fetch";

const client = new OpenAI({ fetch: createFetch() });   // o mesmo para a Anthropic

Como biblioteca

import veu

resultado = veu.anonymize("Oi, sou o João da Silva, CPF 529.982.247-25, tel (11) 91234-5678.")
resultado.text
# 'Oi, sou o [PESSOA_1], CPF [CPF_1], tel [TELEFONE_1].'
veu.restore("Certo, [PESSOA_1]. Vou ligar no [TELEFONE_1].", resultado.vault)
# 'Certo, João da Silva. Vou ligar no (11) 91234-5678.'

Notion, planilhas e documentos

veu ler https://app.notion.com/p/Atendimento-1f2e...             # NOTION_TOKEN no ambiente
veu ler https://docs.google.com/spreadsheets/d/.../edit           # público pelo link ou GOOGLE_ACCESS_TOKEN
veu anonimizar clientes.xlsx -o clientes-protegido.xlsx --cofre cofre.json
veu restaurar resposta.docx --cofre cofre.json -o resposta-final.docx

Comandos

Comando

O que faz

veu painel

Liga o Véu e abre o painel no navegador

veu perfis

Perfis prontos por setor; use com --perfil

veu risco

Aponta pistas que ainda podem identificar alguém (datas, idades, cidades, cargos)

veu demonstrar

Mostra o que chegaria à IA com e sem o Véu e testa ataques à restauração, sem chave de API

veu ler <link ou arquivo>

Lê Notion, Google, links e documentos já protegidos

veu anonimizar / veu restaurar

Protege e restaura textos, CSV, JSON, Excel, Word, PowerPoint e PDF

veu detectar

Lista os dados encontrados num texto

veu verificar

Falha se algum arquivo tiver dados pessoais ou segredos (pre-commit e CI)

veu servir

Proxy para as APIs de IA, com playground e API REST

veu mcp

Servidor MCP para Claude Desktop, Claude Code e Cursor

veu gancho prompt / veu gancho arquivo

Ganchos para Claude Code e Cursor

veu auditoria verificar

Confere a integridade do log de auditoria

veu atalhos

Cria o atalho Véu na área de trabalho

veu avaliar

Roda o benchmark (--externo todos para os conjuntos públicos de terceiros)

Integrações

Categoria

Integrações

Guia

Sem programar

Página que roda no navegador, painel no computador, extensão (Chrome, Edge e Firefox) para ChatGPT, Claude, Gemini, Copilot, Perplexity e outros

Instalar · Extensão

Modelos de IA (proxy)

OpenAI, Anthropic, Gemini, Ollama, Azure OpenAI e 20 provedores prontos (Groq, OpenRouter, DeepSeek, Mistral, xAI, Maritaca, vLLM...)

Modelos

Python

openai_client(), anthropic_client(), transportes httpx, LangChain, @protect, veu.session()

Python

JavaScript

createFetch() para os SDKs da OpenAI e da Anthropic, middleware do AI SDK da Vercel, uso no navegador

@guhttps/veu

Agentes

Servidor MCP (ler_protegido, anonimizar_arquivo...), plugin e ganchos para Claude Code, ganchos para Cursor

Agentes

n8n

Nó "Véu" (esconder e restaurar) e modelo de atendimento por WhatsApp com a Evolution API

n8n

Open WebUI

Filtro que esconde os dados das mensagens e devolve os dados reais nas respostas (beta)

Open WebUI

Fontes

Notion (páginas e bases), Google Docs, Sheets e Slides, links, Excel, Word, PowerPoint e PDF

Fontes

Empresas

Gateway com equipes, login único (OIDC), auditoria encadeada com envio ao SIEM, Redis e desvio para modelo interno; guardrail do LiteLLM; Helm e docker-compose

Empresas

Dados

CSV, JSON, JSONL, Excel, pandas e RAG, com o mesmo marcador em todas as linhas

Dados

Observabilidade

logging, structlog, loguru, Sentry e Prometheus

Observabilidade

Repositórios

Pre-commit e GitHub Action com SARIF, que também acham chaves e senhas

Repositórios

O que é detectado

Tipo

Exemplo

Como

PESSOA

Maria Aparecida da Silva, "oi joão"

listas de nomes, capitalização e contexto

CPF

529.982.247-25

formato + dígitos verificadores

CNPJ

11.222.333/0001-81, 12.ABC.345/01DE-35

numérico e alfanumérico + dígitos

TELEFONE

(11) 91234-5678, +44 20 7946 0958

DDD válido; internacional com +

EMAIL, ENDERECO, CEP

Rua das Flores, 123, apto 45

formato e contexto

IP, PORTA, SERVIDOR

10.0.0.5:8080, db.interna:5432

IPv4 e IPv6 válidos; porta só colada a um IP ou servidor, depois de "porta" ou PORT= ou no -p de comandos de rede (nunca um número solto); servidores com terminação interna (.local, .internal, .corp, .lan)

RG, CNH, TITULO_ELEITOR, PIS, CNS, RENAVAM, PASSAPORTE

—

contexto e dígitos verificadores

PLACA

ABC-1234, BRA2E19

padrão antigo e Mercosul

CARTAO_CREDITO, CONTA_BANCARIA, CHAVE_PIX, IBAN

DE89 3704 0044 0532 0130 00

Luhn, módulo 97 e contexto

DATA_NASCIMENTO, PROCESSO

nascida em 12/03/1990

contexto e dígitos do CNJ

CHAVE_API

sk-proj-..., AKIA..., ghp_..., APP_USR-...

prefixos de mais de 30 serviços

TOKEN

eyJhbGci..., Bearer ...

JWT, Bearer e Basic

SENHA, SEGREDO

DB_PASSWORD=..., clientSecret: ...

nome do campo + cara de valor aleatório

CHAVE_PRIVADA, URL_CONEXAO

-----BEGIN PRIVATE KEY-----, postgres://u:senha@host

formato

NIF_PT, CC_PT, NISS_PT

NIF 123 456 789, Cartão de Cidadão 12345678 9 ZZ1

Portugal: dígitos verificadores e contexto

CUIT, DNI, CURP, RFC, RUT, CEDULA, NIT, RUC, RIF

20-12345678-6, XAXX900101HDFXXX03, 12.345.678-5

Argentina, México, Chile, Uruguai, Colômbia, Peru, Equador, Paraguai e Venezuela: dígitos verificadores e contexto

NUIT, BI_AO, BI_MZ

NUIT 123 456 785, BI 123456789LA123

Moçambique e Angola: dígito verificador (NUIT), formato e contexto

SSN, MBI

123-45-6789, ITIN 900-70-1234, MBI 1EG4-TE5-MK73

EUA: faixas válidas do SSN e do ITIN; Medicare com contexto

DNI_ES, CODICE_FISCALE, NIR, STEUER_ID, NINO, NHS, BSN

12345678Z, RSSMRA80A01H501U, AB 12 34 56 C

Espanha, Itália, França, Alemanha, Reino Unido e Países Baixos: dígitos verificadores e contexto

SIN, AADHAAR, PAN

SIN 123 456 782, Aadhaar 2345 6789 0124

Canadá (Luhn) e Índia (Verhoeff), com contexto

MRZ, VIN, CRIPTO

P<UTOERIKSSON<<ANNA<MARIA<<<..., 1M8GDM9AXKP042788, bc1q...

passaporte (dígitos da ICAO 9303), chassi e carteiras (Base58Check, bech32)

Formatos estruturados (CURP, RFC, Cartão de Cidadão, CUIT e RIF com a pontuação típica, SSN com hífens, DNI espanhol, codice fiscale, NIR com espaços, MRZ, VIN e carteiras) são reconhecidos sozinhos. Números puros, que um CPF ou um protocolo poderiam imitar, só com a palavra de contexto por perto ("NIF", "CUIT", "RUC", "cédula", "BSN", "SIN", "Aadhaar"). Num formato que existe nos dois lados, como 12.345.678-5, sem contexto, vence o rótulo brasileiro.

Também dá para adicionar padrões próprios (matrícula, número de cliente...) no veu.toml.

Operadores

Operador

Resultado

Reversível

token (padrão)

[CPF_1]

sim

sintetico

686.192.633-74 (outro CPF válido), outro nome, chave falsa no mesmo formato

sim

mascara

***.982.247-**, sk-proj-****

não

remover

[CPF]

não

generalizar

nascida em 1985, CEP 01310-***, (11) ****-****, 192.0.2.0/24; o resto vira [TIPO]

não

hash

[CPF_3fa2c1d9e07b4a12], estável entre requisições com o mesmo VEU_SEGREDO (mínimo de 32 caracteres)

sim, com o cofre

O operador sintetico ainda só existe em Python. Em JavaScript, use token, mascara, remover ou hash.

Benchmark

A métrica principal é o vazamento: a fração dos dados pessoais que chegaria à IA sem estar totalmente escondida. O Véu é medido com conjuntos próprios e com dois conjuntos públicos escritos por outras equipes, e comparado com o Microsoft Presidio nos mesmos textos.

veu avaliar                    # conjuntos próprios
veu avaliar --externo todos    # BR-Agentic e privacy-filter-br (baixados uma vez, versão fixa)

Conjunto

Véu

Véu + ml

Véu + spaCy

Presidio

Desafio: 41 textos escritos à mão e congelados

22,0%

8,0%

14,0%

50,0%

BR-Agentic: conversas bancárias com ferramentas

22,2%

21,4%¹

16,9%

53,1%

privacy-filter-br: 3.000 documentos

0,4%

0,2%

0,3%

52,0%

Validação própria: 1.000 textos de modelos não usados no ajuste

2,5%

0,0%

1,2%

—

Velocidade (caracteres por segundo)

~300 mil

2 a 7 mil

~19 mil

7 a 28 mil

¹ O modelo do detector ml foi treinado com o BR-Agentic; esse número não mede generalização.

Como ler esses números com honestidade:

  • Os conjuntos externos são o número que importa. O ajuste dos detectores nunca olha para eles nem para o desafio. Os números próprios são melhores porque o gerador e o detector foram escritos pela mesma pessoa.

  • Documentos brasileiros são a maior vantagem: o Presidio não tem reconhecedores de CPF, CNPJ, RG ou endereços brasileiros e vaza 90% dos CPFs; o Véu, menos de 1%.

  • Nomes são a parte difícil. Com as listas do Censo 2022, o vazamento de nomes no privacy-filter-br caiu de 15,4% para 1,4%. Nomes sem contexto e de outras origens ainda passam. O detector ml zera o vazamento de nomes no desafio (de 35% para 0%) com a mesma precisão, mas deixa o Véu cerca de cem vezes mais lento: vale para lotes e documentos, não para cada tecla.

  • Endereços completos e contas sem a palavra "conta" ainda vazam no BR-Agentic.

  • Todos os textos são sintéticos. Em dados reais, espere resultados piores. Teste com uma amostra dos seus textos (veu avaliar --dataset).

Detalhes da metodologia em docs/benchmark.md.

Configuração

Quem usa o painel não precisa editar nada: as caixinhas gravam a configuração. Quem preferir pode escrever um veu.toml (exemplo completo em examples/veu.toml):

[deteccao]
limiar = 0.5                                   # 0 a 1; mais alto = menos falsos positivos
ignorar = ["contato@minhaempresa.example"]      # valores que nunca são escondidos

[anonimizacao]
operador = "token"

[politica]
bloquear = ["CARTAO_CREDITO", "CHAVE_PRIVADA"] # recusa o pedido em vez de só esconder

[restauracao]
links = false                                  # dados reais nunca voltam dentro de links e URLs
segredos_em_ferramentas = false                # chaves e senhas não voltam nos argumentos de ferramentas
so_eco = false                                 # true: cada resposta só recebe os dados da própria requisição

[servidor]
log_auditoria = "veu-auditoria.jsonl"          # só contagens, nunca os valores, em cadeia de hashes

O painel guarda o arquivo em %APPDATA%\veu\veu.toml no Windows, ~/Library/Application Support/veu/veu.toml no Mac e ~/.config/veu/veu.toml no Linux. Equipes, sessões no Redis, desvio para modelo interno e leitura de links do Notion estão no guia para empresas.

Segurança

  • Acesso:

    • o Véu ouve só em 127.0.0.1 por padrão e recusa pedidos de outros sites abertos no navegador (CSRF e DNS rebinding);

    • fora do computador local, ele não inicia sem token;

    • cada equipe pode ter o seu token e a sua política.

  • Restauração:

    • a resposta da IA nunca recebe os dados reais dentro de links, imagens, URLs ou atributos HTML, nem em streaming;

    • chaves, tokens e senhas não voltam nos argumentos das ferramentas de agentes;

    • ferramentas de rede e mensagens (send_email, WebFetch, http_request...) e comandos de rede (curl, wget) nunca recebem dados reais, nem no corpo da requisição;

    • no modo só eco (so_eco), cada pessoa só recebe de volta os dados que ela mesma enviou;

    • marcadores que chegam escritos por terceiros são desarmados antes do envio;

    • no MCP, a ferramenta que devolve os dados reais para a conversa vem desligada.

  • Dados:

    • se a detecção falhar, a requisição não sai;

    • o cofre fica na memória (ou no seu Redis, cifrado com AES-256-GCM) e expira sem uso;

    • a leitura de links do proxy só acessa endereços públicos, também nos redirecionamentos;

    • a página web e a extensão não enviam nada pela internet;

    • o painel só funciona no próprio computador.

  • Auditoria: o log tem só contagens (do que foi escondido e do que voltou), em cadeia de hashes (HMAC com segredo). veu auditoria verificar aponta linhas alteradas ou removidas, e a âncora (veu auditoria ancorar) acusa linhas apagadas no fim.

  • Limites: o Véu protege os dados da IA, mas não decide quem pode ver o quê dentro do seu sistema. Veja as limitações.

Leia o modelo de ameaças e as limitações antes de usar em produção.

Desenvolvimento

git clone https://github.com/guhttps/veu && cd veu
python -m venv .venv && .venv/Scripts/activate      # Linux/macOS: source .venv/bin/activate
pip install -e ".[dev]"
pytest                    # 822 testes, inclusive com os SDKs oficiais, LangChain, MCP, Office e Redis
ruff check .
veu avaliar               # benchmark
VEU_HIPOTESES=5000 pytest tests/test_propriedades.py   # testes de propriedade com uma busca longa
cd js && npm ci && npm test                       # biblioteca JavaScript (inclui a conformidade com o Python)
node extensao/teste/e2e.mjs                        # extensão e página num Chrome de verdade

Para ver o site de documentação no seu computador: pip install zensical==0.1.0 e python scripts/gerar_site.py --servir. Veja o guia de contribuição. Contribuições de nomes, padrões de documentos, formatos de chaves e casos difíceis são muito bem-vindas.

Próximos passos

  • Publicar no PyPI (pip install veu) e no npm (@guhttps/veu)

  • Instalador de um comando e painel para quem não programa

  • Restauração segura contra injeção de prompt (links, ferramentas, marcadores forjados)

  • Benchmark com dados em português de terceiros, comparado ao Presidio

  • Cache de detecção para agentes que reenviam a conversa inteira a cada turno

  • Nó para o n8n (WhatsApp com IA sem expor o CPF do cliente)

  • Documentos de Portugal e da América Latina (CUIT, CURP, RFC, RUT, NIT, RUC, RIF e cédulas)

  • Documentos de Angola, Moçambique, Estados Unidos, Canadá, Índia e Europa; MRZ de passaporte, VIN e carteiras de criptomoeda

  • Site de documentação com busca

  • Homebrew (brew install guhttps/veu/veu) e Scoop (scoop bucket add veu https://github.com/guhttps/scoop-veu)

  • Extensão nas lojas do Edge e do Firefox (textos, capturas e política de privacidade prontos em extensao/loja/)

  • Nomes de outras línguas sem precisar de modelo

  • Abrir Excel e Word direto na página web, sem instalar nada

  • Operador sintético na versão JavaScript

  • Bibliotecas para Go e Java

  • Mais casos difíceis escritos à mão, de domínios reais (com dados fictícios)

  • Detector de nomes em minúsculas sem saudação ("o rayane esqueceu")

Licença

MIT. Os dados usados nos exemplos e no benchmark são fictícios. As listas de nomes e municípios vêm do IBGE (Censo Demográfico 2022, Nomes do Brasil, e Localidades), dados públicos.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      Zero-Trust local PII & secrets masking MCP (ZTDS RFC v1.0). Zero server logs. Features: 23 zero-trust tools, 30 industry profiles, offline OCR, RAM-only masking. Run: npx -y @privacyscrubber/mcp-server. Website: https://privacyscrubber.com SDK: https://www.npmjs.com/package/@privacyscrubber/sdk
      4
      23
      794 npm
      274 PyPI
      3
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Detects and redacts sensitive personal information such as names, emails, phone numbers, ID numbers, and locations in text before it is processed by AI agents, using configurable mask, hash, or remove strategies.
      1
      MIT