Repository avatar
AI Tools
v0.7.1
active

veu

io.github.guhttps/veu

Hides personal data and secrets before text reaches an AI and restores them in the answer.

Documentation

Véu: esconde dados pessoais e segredos 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

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.

A página do Véu: um pedido de atendimento com nome, e-mail, CPF e telefone vira marcadores, e a resposta da IA volta com os dados reais

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 detector ml (um modelo treinado em português que roda na sua máquina).

[!IMPORTANT] Nenhuma detecção automática é perfeita. O Véu reduz 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...UseComo
colar textos no ChatGPT, no Claude ou no Gemini sem expor dadosA página do Véu: cole, copie a versão protegida, traga a resposta de voltaNada para instalar
proteger planilhas, documentos e PDFs ou conectar o Claude Desktop, sem programarO painel do Véu, no seu computadorUm comando, 2 minutos
proteger aplicativos como n8n, Make e ZapierO painel mostra o endereço para colar no aplicativoUm comando, 2 minutos
programar em Pythonopenai_client(), anthropic_client(), LangChain, @protectpip install veu
programar em JavaScript ou TypeScript@guhttps/veu, com createFetch() e middleware do AI SDKnpm install @guhttps/veu
proteger o Claude Code ou o CursorO plugin: bloqueia segredos em prompts e arquivos/plugin install veu --marketplace guhttps/veu
proteger a empresa toda sem instalar nada nos computadoresGateway central, guardrail do LiteLLM ou extensão gerenciadaGuia 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. 37Conformidade

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.

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 (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:

ExtraPara
servidorProxy, painel e API REST
mcpServidor MCP para agentes
documentosExcel, Word, PowerPoint e PDF
langchain, pandasIntegrações com essas bibliotecas
litellmGuardrail do LiteLLM
redisSessões compartilhadas entre réplicas, com o cofre cifrado
oidcLogin único no gateway com o provedor de identidade da empresa
spacyDetector de nomes do spaCy
mlDetector de nomes por um modelo BERT em português (transformers e torch; cerca de 400 MB)
todosTudo 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

ComandoO que faz
veu painelLiga o Véu e abre o painel no navegador
veu perfisPerfis prontos por setor; use com --perfil
veu riscoAponta pistas que ainda podem identificar alguém (datas, idades, cidades, cargos)
veu demonstrarMostra 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 restaurarProtege e restaura textos, CSV, JSON, Excel, Word, PowerPoint e PDF
veu detectarLista os dados encontrados num texto
veu verificarFalha se algum arquivo tiver dados pessoais ou segredos (pre-commit e CI)
veu servirProxy para as APIs de IA, com playground e API REST
veu mcpServidor MCP para Claude Desktop, Claude Code e Cursor
veu gancho prompt / veu gancho arquivoGanchos para Claude Code e Cursor
veu auditoria verificarConfere a integridade do log de auditoria
veu atalhosCria o atalho Véu na área de trabalho
veu avaliarRoda o benchmark (--externo todos para os conjuntos públicos de terceiros)

Integrações

CategoriaIntegraçõesGuia
Sem programarPágina que roda no navegador, painel no computador, extensão (Chrome, Edge e Firefox) para ChatGPT, Claude, Gemini, Copilot, Perplexity e outrosInstalar · Extensão
Modelos de IA (proxy)OpenAI, Anthropic, Gemini, Ollama, Azure OpenAI e 20 provedores prontos (Groq, OpenRouter, DeepSeek, Mistral, xAI, Maritaca, vLLM...)Modelos
Pythonopenai_client(), anthropic_client(), transportes httpx, LangChain, @protect, veu.session()Python
JavaScriptcreateFetch() para os SDKs da OpenAI e da Anthropic, middleware do AI SDK da Vercel, uso no navegador@guhttps/veu
AgentesServidor MCP (ler_protegido, anonimizar_arquivo...), plugin e ganchos para Claude Code, ganchos para CursorAgentes
n8nNó "Véu" (esconder e restaurar) e modelo de atendimento por WhatsApp com a Evolution APIn8n
Open WebUIFiltro que esconde os dados das mensagens e devolve os dados reais nas respostas (beta)Open WebUI
FontesNotion (páginas e bases), Google Docs, Sheets e Slides, links, Excel, Word, PowerPoint e PDFFontes
EmpresasGateway com equipes, login único (OIDC), auditoria encadeada com envio ao SIEM, Redis e desvio para modelo interno; guardrail do LiteLLM; Helm e docker-composeEmpresas
DadosCSV, JSON, JSONL, Excel, pandas e RAG, com o mesmo marcador em todas as linhasDados
Observabilidadelogging, structlog, loguru, Sentry e PrometheusObservabilidade
RepositóriosPre-commit e GitHub Action com SARIF, que também acham chaves e senhasRepositórios

O que é detectado

TipoExemploComo
PESSOAMaria Aparecida da Silva, "oi joão"listas de nomes, capitalização e contexto
CPF529.982.247-25formato + dígitos verificadores
CNPJ11.222.333/0001-81, 12.ABC.345/01DE-35numérico e alfanumérico + dígitos
TELEFONE(11) 91234-5678, +44 20 7946 0958DDD válido; internacional com +
EMAIL, ENDERECO, CEPRua das Flores, 123, apto 45formato e contexto
IP, PORTA, SERVIDOR10.0.0.5:8080, db.interna:5432IPv4 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
PLACAABC-1234, BRA2E19padrão antigo e Mercosul
CARTAO_CREDITO, CONTA_BANCARIA, CHAVE_PIX, IBANDE89 3704 0044 0532 0130 00Luhn, módulo 97 e contexto
DATA_NASCIMENTO, PROCESSOnascida em 12/03/1990contexto e dígitos do CNJ
CHAVE_APIsk-proj-..., AKIA..., ghp_..., APP_USR-...prefixos de mais de 30 serviços
TOKENeyJhbGci..., Bearer ...JWT, Bearer e Basic
SENHA, SEGREDODB_PASSWORD=..., clientSecret: ...nome do campo + cara de valor aleatório
CHAVE_PRIVADA, URL_CONEXAO-----BEGIN PRIVATE KEY-----, postgres://u:senha@hostformato
NIF_PT, CC_PT, NISS_PTNIF 123 456 789, Cartão de Cidadão 12345678 9 ZZ1Portugal: dígitos verificadores e contexto
CUIT, DNI, CURP, RFC, RUT, CEDULA, NIT, RUC, RIF20-12345678-6, XAXX900101HDFXXX03, 12.345.678-5Argentina, México, Chile, Uruguai, Colômbia, Peru, Equador, Paraguai e Venezuela: dígitos verificadores e contexto
NUIT, BI_AO, BI_MZNUIT 123 456 785, BI 123456789LA123Moçambique e Angola: dígito verificador (NUIT), formato e contexto
SSN, MBI123-45-6789, ITIN 900-70-1234, MBI 1EG4-TE5-MK73EUA: faixas válidas do SSN e do ITIN; Medicare com contexto
DNI_ES, CODICE_FISCALE, NIR, STEUER_ID, NINO, NHS, BSN12345678Z, RSSMRA80A01H501U, AB 12 34 56 CEspanha, Itália, França, Alemanha, Reino Unido e Países Baixos: dígitos verificadores e contexto
SIN, AADHAAR, PANSIN 123 456 782, Aadhaar 2345 6789 0124Canadá (Luhn) e Índia (Verhoeff), com contexto
MRZ, VIN, CRIPTOP<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

OperadorResultadoReversível
token (padrão)[CPF_1]sim
sintetico686.192.633-74 (outro CPF válido), outro nome, chave falsa no mesmo formatosim
mascara***.982.247-**, sk-proj-****não
remover[CPF]não
generalizarnascida 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)
ConjuntoVéuVéu + mlVéu + spaCyPresidio
Desafio: 41 textos escritos à mão e congelados22,0%8,0%14,0%50,0%
BR-Agentic: conversas bancárias com ferramentas22,2%21,4%¹16,9%53,1%
privacy-filter-br: 3.000 documentos0,4%0,2%0,3%52,0%
Validação própria: 1.000 textos de modelos não usados no ajuste2,5%0,0%1,2%—
Velocidade (caracteres por segundo)~300 mil2 a 7 mil~19 mil7 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.

PYPI
veu
Install Command
pip install veu
Runtime: uvx