Skip to main content

Véu: esconde CPF, nomes, telefones e endereços antes de o texto chegar à IA e devolve os dados reais na resposta

CI PyPI npm Python 3.11 a 3.14 Núcleo sem dependências Licença MIT

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], [CPF_1] e [CHAVE_API_1]. Você vê "Maria Souza", "529.982.247-25" e a chave de verdade.

Você envia     Sou a Maria Souza, CPF 529.982.247-25. Meu pedido atrasou.
A IA recebe    Sou a [PESSOA_1], CPF [CPF_1]. Meu pedido atrasou.
A IA responde  Olá, [PESSOA_1]! Localizei o pedido do CPF [CPF_1].
Você recebe    Olá, Maria Souza! Localizei o pedido do CPF 529.982.247-25.

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

  • Entende documentos brasileiros de verdade: confere os dígitos verificadores, inclusive do CNPJ alfanumérico de 2026.
  • Reconhece segredos: chaves de mais de 30 serviços, tokens, senhas e chaves privadas.
  • Funciona do jeito que você usa IA: no navegador, no computador, no seu código ou no servidor da empresa.

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

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, sem precisar de chave de API.

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.

Painel do Véu: proteger um arquivo, proteger um texto e conectar aplicativos

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, dados financeiros, senhas e outros;
    • 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 (só contagens, nunca os valores).

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

Recursos

  • 🇧🇷 28 tipos de dados:

    • documentos brasileiros: CPF, CNPJ, RG, CNH, título de eleitor, PIS/NIT, cartão do SUS e passaporte;
    • contatos e localização: nomes de pessoas, telefone (brasileiro e internacional), e-mail, endereço, CEP e IP;
    • financeiros: cartão, conta bancária, IBAN e chave Pix;
    • outros: placa, RENAVAM, data de nascimento e processo do CNJ;
    • segredos.
  • 🔑 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:

    • listas de nomes brasileiros, capitalização e contexto ("Sr.", "cliente", "oi joão");
    • não confunde "Banco do Brasil" nem "Rua Augusta";
    • opcionalmente, spaCy ou um modelo local.
  • 🔁 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).
  • 🌊 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 235 casos exige resultados idênticos.
  • 🏢 Empresas:

    • gateway com tokens por equipe, auditoria à prova de adulteração e sessões no Redis;
    • desvio de dados sensíveis para um modelo interno;
    • chart Helm, guardrail do LiteLLM e extensão com política gerenciada.
  • 🤖 Agentes: servidor MCP, ganchos para Claude Code e Cursor e plugin com skill. O agente trabalha com arquivos sensíveis sem ver os dados.

  • 🪶 Leve: o núcleo não tem dependências e processa cerca de 330 mil caracteres por segundo.

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

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
spacy Detector de nomes do spaCy
todos Tudo acima, menos litellm e spacy

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 demonstrar Mostra o que chegaria à IA com e sem o Véu, 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

Integrações

Categoria Integrações Guia
Sem programar Página que roda no navegador, painel no computador, extensão 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
Fontes Notion (páginas e bases), Google Docs, Sheets e Slides, links, Excel, Word, PowerPoint e PDF Fontes
Empresas Gateway com equipes, auditoria encadeada, 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, IP Rua das Flores, 123, apto 45 formato e contexto
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

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
hash [CPF_3fa2c1d9], estável entre requisições com o mesmo VEU_SEGREDO sim, com o cofre

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

Benchmark

O Véu vem com um gerador de textos realistas (atendimento, saúde, jurídico, RH, conversas de WhatsApp, formulários) com dados falsos e anotados, e com um conjunto de casos difíceis escritos à mão. A métrica principal é o vazamento: a fração dos dados pessoais que chegaria à IA sem estar totalmente escondida.

veu avaliar --quantidade 1000
Conjunto Textos Precisão Revocação Vazamento geral Vazamento de nomes
Validação (modelos de texto não usados para ajustar o detector) 1.000 100,0% 97,5% 2,5% 6,5%
Validação, com o detector spaCy ligado 1.000 97,8% 98,6% 1,2% 3,0%
Casos difíceis escritos à mão 25 100,0% 100,0% 0,0% 0,0%
Desenvolvimento (modelos usados no ajuste) 1.000 100,0% 100,0% 0,0% 0,0%

Como ler esses números com honestidade:

  • O número que importa é o da validação. O conjunto de desenvolvimento chega a 100% porque o detector foi ajustado olhando para ele.
  • Documentos com dígitos verificadores (CPF, CNPJ, cartão, processo...) ficaram em 0% de vazamento nos três conjuntos.
  • Nomes são a parte difícil, principalmente em minúsculas, em conversas sem saudação ("kkkk o rayane esqueceu").
  • O spaCy reduz o vazamento de nomes para menos da metade, mas é cerca de 18 vezes mais lento.
  • Os textos são sintéticos. Em dados reais, espere resultados piores. Teste com uma amostra dos seus próprios textos antes de confiar.

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

[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.
  • Dados:
    • o cofre fica na memória (ou no seu Redis) e expira sem uso;
    • 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, em cadeia de hashes (HMAC com segredo). veu auditoria verificar aponta linhas alteradas ou removidas.
  • 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                    # 295 testes, inclusive com os SDKs oficiais, LangChain, MCP, Office e Redis
ruff check .
veu avaliar               # benchmark
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

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
  • 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.

Metadata

Release files for veu 0.5.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for veu 0.5.2
File Size Uploaded Provenance Actions
veu-0.5.2.tar.gz 610.8 kB With provenance Details for veu-0.5.2.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for veu 0.5.2
File Interpreter ABI Platform Actions
veu-0.5.2-py3-none-any.whl Python 3 none any Details for veu-0.5.2-py3-none-any.whl

Total release size: 778.3 kB

Release files / veu-0.5.2.tar.gz

Download URL veu-0.5.2.tar.gz
Size 610.8 kB
Tags Source
SHA-256 checksum
How to use checksums
9323a79044c47cb68b07db57fcd57ce912fb56490d25785f6ee4b167beadb50c
BLAKE2b-256 checksum
How to use checksums
dfeb0c8b921ad4036d71ab08a37aec6eafc052b0ba83cd0bd03f622f7900ecca
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Release files / veu-0.5.2-py3-none-any.whl

Download URL veu-0.5.2-py3-none-any.whl
Size 167.5 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5c19def69f100af89ba9da204f9b17d5d74d43973ff4a30528563d5bada88166
BLAKE2b-256 checksum
How to use checksums
8459fed3120ca5e607e87b8e32a6c5de97c54e29b5d97629fbdccd2d21f934fe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

Security for veu 0.5.2

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for veu-0.5.2.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Nov 7, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page