Véu
O Véu esconde dados pessoais e segredos antes de um texto chegar a um modelo de IA e devolve os dados reais na resposta. A IA trabalha com [PESSOA_1], [CPF_1] e [CHAVE_API_1]. Quem usa vê "Maria Souza", "529.982.247-25" e a chave de verdade.
Empresas 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, senhas e URLs de banco de dados. 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 em streaming.
- Chega de vários jeitos: página web, extensão de navegador, biblioteca Python ou JavaScript, proxy, gateway da empresa, plugin para agentes de código.
Você envia Sou a Maria Souza, CPF 529.982.247-25. Use a chave sk-proj-4f...
A IA recebe Sou a [PESSOA_1], CPF [CPF_1]. Use a chave [CHAVE_API_1]
A IA responde Olá, [PESSOA_1]! Configurei [CHAVE_API_1] no .env.
Você recebe Olá, Maria Souza! Configurei sk-proj-4f... no .env.
Comece por aqui
| Você... | Use | Instalação |
|---|---|---|
| usa ChatGPT, Claude ou Gemini no navegador e não programa | A página do Véu: cole, copie a versão protegida, traga a resposta de volta. Tudo roda no seu navegador. | nenhuma |
| A extensão para Chrome e Edge, que protege o que você cola e digita nos sites das IAs | um clique | |
| programa em Python | openai_client(), anthropic_client(), LangChain, @protect, MCP |
pip install "veu @ git+https://github.com/guhttps/veu" |
| programa em JavaScript ou TypeScript | veu-js: createFetch() para os SDKs da OpenAI e da Anthropic e middleware para o AI SDK da Vercel |
npm install veu-js |
| usa Claude Code ou Cursor | O plugin: bloqueia segredos nos prompts e nos arquivos e lê Notion, planilhas e documentos já protegidos | /plugin install veu --marketplace guhttps/veu |
| é da TI de uma empresa | Gateway central (Helm ou Docker), guardrail para o LiteLLM ou a extensão gerenciada por política. Nada é instalado nos computadores. | guia para empresas |
| quer dar Notion, planilhas ou PDFs para a IA | veu ler <link ou arquivo> e veu anonimizar planilha.xlsx |
fontes e documentos |
Quer ver funcionando sem chave de API? Rode veu demonstrar: ele mostra, dado por dado, o que chegaria à IA com e sem o Véu.
Recursos
-
🇧🇷 28 tipos de dados:
- documentos brasileiros: CPF, CNPJ (numérico e alfanumérico), 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, GitLab, Stripe, Slack, Hugging Face, Groq, Notion, Mercado Pago, Asaas e mais 20 serviços;
- JWT e tokens Bearer;
- senhas (
DB_PASSWORD=..., "a senha é ..."); - chaves privadas;
- URLs de banco com senha;
- campos como
api_key: ....
-
✅ Validação de verdade:
- dígitos verificadores de CPF, CNPJ, PIS, CNS, CNH, título, RENAVAM, processo CNJ, IBAN e Luhn;
- DDDs válidos.
Um número qualquer de 11 dígitos não vira CPF, e
max_tokens: 2048nã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", "Rua Augusta" nem "São José dos Campos";
- 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 de verdade:
- marcadores partidos entre pedaços ("[PES" + "SOA_1]") são remontados;
- vale também para 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 Word, Excel 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.
-
🏢 Pronto para empresas:
- gateway central com tokens por equipe e auditoria encadeada à prova de adulteração;
- sessões no Redis para várias réplicas;
- desvio de dados sensíveis para um modelo interno;
- chart Helm, guardrail para o LiteLLM e extensão com política gerenciada.
-
🤖 Agentes:
- servidor MCP, ganchos para Claude Code e Cursor e plugin com skill;
- o agente consegue trabalhar com arquivos sensíveis sem ver os dados.
-
🎭 5 operadores: marcador, valor sintético (outro CPF válido), máscara, remoção e hash estável.
-
🪶 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 sua aplicação<br/>(navegador, 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["Modelo de 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ê (na memória, no navegador ou no seu servidor) e nunca é enviado ao modelo. Uma instrução curta avisa o modelo para repetir os marcadores sem tentar adivinhar os valores.
Instalação
pip install "veu[servidor] @ git+https://github.com/guhttps/veu"
-
Biblioteca Python sem dependências:
pip install "veu @ git+https://github.com/guhttps/veu"
-
Extras opcionais:
mcp: servidor para agentes;documentos: Word, Excel, PowerPoint e PDF;langchainepandas;litellm: guardrail;redis: sessões compartilhadas;spacy;todos, que instala os anteriores.
Exemplo:
pip install "veu[servidor,mcp,documentos] @ git+https://github.com/guhttps/veu"
-
JavaScript e TypeScript:
npm install veu-js. Veja o js/README.md. -
Docker:
docker run -p 8787:8787 -e VEU_TOKEN=um-segredo ghcr.io/guhttps/veu
O token é obrigatório fora do localhost. Para a empresa toda, veja o guia para empresas.
Uso rápido
1. Como proxy (qualquer linguagem, muda uma linha)
veu servir # http://127.0.0.1:8787, com playground em /veu/playground
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...
2. 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 "veu-js/fetch";
const client = new OpenAI({ fetch: createFetch() }); // o mesmo para a Anthropic
3. 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.'
4. Notion, planilhas e documentos
veu ler https://www.notion.so/minha-empresa/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
Integrações
| Categoria | Integrações | Guia |
|---|---|---|
| No navegador | Página que roda localmente; extensão para ChatGPT, Claude, Gemini, Copilot, Perplexity, DeepSeek, Mistral, Grok e outros | Extensão |
| Modelos de IA (proxy) | OpenAI, Anthropic, Gemini, Ollama nativo, 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() |
SDKs |
| JavaScript | createFetch() para os SDKs da OpenAI e da Anthropic, middleware do AI SDK da Vercel, uso no navegador |
veu-js |
| Agentes | Servidor MCP (ler_protegido, anonimizar_arquivo...), ganchos e plugin com skill para Claude Code, ganchos para Cursor |
Agentes |
| Fontes | Notion (páginas e bases), Google Docs/Sheets/Slides, links; Word, Excel, PowerPoint e PDF | Fontes |
| Empresas | Gateway com equipes, auditoria encadeada, Redis, 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 (agora 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 um conjunto de casos difíceis escritos à mão. A métrica principal é o vazamento: a fração dos dados pessoais que chegaria ao modelo 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 detector de segredos não mudou a precisão: com ele ligado, os números da validação são os mesmos.
- 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
Tudo funciona sem configuração. Para ajustar, crie 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 a requisição em vez de só esconder
[servidor]
log_auditoria = "veu-auditoria.jsonl" # só contagens, nunca os valores, em cadeia de hashes
Equipes, sessões no Redis, desvio para modelo interno e expansão de links do Notion estão no guia para empresas.
Segurança
- Acesso:
- o Véu ouve só em
127.0.0.1por padrão e recusa requisições de outros sites (CSRF e DNS rebinding); - fora do localhost, ele não inicia sem token;
- cada equipe pode ter o seu token e a sua política.
- o Véu ouve só em
- Dados:
- o cofre fica na memória (ou no seu Redis) e expira sem uso;
- sessões de credenciais diferentes nunca compartilham o cofre;
- a página e a extensão não enviam nada pela internet.
- Auditoria: o log tem só contagens, em cadeia de hashes (HMAC com segredo).
veu auditoria verificaraponta linhas alteradas ou removidas. - Limites: o Véu protege os dados do provedor de IA, mas não decide quem pode ver o quê dentro da sua aplicação. 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 # 282 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), no npm (veu-js) e na Chrome Web Store - Operador sintético na versão JavaScript
- 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")
- Biblioteca para Go e Java
- Suporte à API Realtime e a uploads de arquivos
Licença
MIT. Os dados usados nos exemplos e no benchmark são fictícios.
Metadata
Release files for veu 0.4.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| veu-0.4.0.tar.gz | 631.1 kB | With provenance | Details for veu-0.4.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| veu-0.4.0-py3-none-any.whl | Python 3 | none | any | Details for veu-0.4.0-py3-none-any.whl |
Total release size: 773.4 kB
Release files / veu-0.4.0.tar.gz
| Download URL | veu-0.4.0.tar.gz |
|---|---|
| Size | 631.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
3db447735b3e9e3a0f66e1f3f1112e858af0e1ac873eeaad5b5278306bb7a98d
|
|
BLAKE2b-256 checksum How to use checksums |
5771ba6b89100450381e8c82a68b8b3027dfc07bc3ebc4767c53b109f3823f2c
|
| 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 6, 2026.
Transparency logRelease files / veu-0.4.0-py3-none-any.whl
| Download URL | veu-0.4.0-py3-none-any.whl |
|---|---|
| Size | 142.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a4d5ae904fa8a739ca5b58e10d030f35a663bedac36b7be27f9a352aa1f2a5ca
|
|
BLAKE2b-256 checksum How to use checksums |
92934a93025c5919734e3e799ace776d455b320903360002c8da84143d9a7c3a
|
| 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 6, 2026.
Transparency logSecurity for veu 0.4.0
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.
Attestation for veu-0.4.0.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 6, 2026.
Transparency logA 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.