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, 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)