~/pilulabs/botai
Botaí: Dados de teste brasileiros em todo lugar que o seu teste roda.
O Botaí é um gerador de pessoa de teste: ele cria uma pessoa brasileira fictícia e coerente, com CPF, CEP, celular e empresa que batem entre si, e preenche formulários com ela. Um motor só, com oito portas: extensão, CLI, biblioteca, HTTP, Docker, binários, Playwright e o motor direto na página.
npx @pilutech/botai-core@0.5.0 pessoa --semente 42 --hoje 2026-10-05npx @pilutech/botai-core@0.5.0 pessoa --semente 42 --hoje 2026-10-05{"formato": 2,"motor": "0.5.0","semente": "42","hoje": "2026-10-05","pessoa": {"nome": { …, "completo": "Márcio Carvalho Rodrigues", … }, …,"cpf": "634.132.403-07", …,"celular": { …, "formatado": "(98) 97702-9128", … },"email": { …, "endereco": "marcio-rodrigues-0337@tuamaeaquelaursa.com", … }, …,"endereco": { "cep": "65071-377", …, "cidade": "São Luís", "uf": "MA", … },"empresa": { …, "cnpj": "90.849.558/0001-39" }, …}}
Criar conta
6 de 6 campos preenchidos
43/43
campos iguais em 15 saídas, com a mesma semente e o mesmo dia
~2 s
para 100 mil pessoas pela CLI, sem repetir CPF, e-mail nem CNPJ
1.454
testes automatizados passando
12
arquivos dourados iguais da 0.2.0 à 0.4.1
0,8 ms
mediana para o motor preencher 21 campos, sem a 2ª passada
0
dependências de runtime no core
medido em 08/10/2026, num Mac arm64 com Node 22 · código aberto, licença MIT
Portas
01Um motor, oito portas.
Todas usam o mesmo gerador, e as que preenchem formulário usam o mesmo motor. Escolha a que cabe no seu teste.
Extensão
porta 01
Preenche o formulário da aba num atalho, ou um campo só pelo botão direito.
Chrome 123+ e Edge pela Chrome Web Store, Firefox 153+ pela Firefox Add-ons. Opera em revisão.
⌥⇧P no Mac · Ctrl+Shift+Y no Windows e no Linux · Alt+Shift+P no Firefox para LinuxCLI
porta 02
Uma pessoa ou um lote em JSON, NDJSON, CSV ou SQL, direto no banco.
Onde houver Node.
npx -y @pilutech/botai-core@0.5.0 pessoas -n 1000 --semente carga --hoje 2026-10-05 --formato sql | psql "$DATABASE_URL"HTTP
porta 03
Python, Go, Java ou qualquer linguagem que fale HTTP pede uma pessoa.
Node, imagem ou binário.
curl 'http://127.0.0.1:8790/pessoa?semente=42&hoje=2026-10-05'Docker
porta 04
O servidor numa imagem, que entra como service no CI.
linux/amd64 e linux/arm64.
docker run --rm -p 8790:8790 ghcr.io/piluvitu/botai:0.5.0Binários
porta 05
A CLI e o servidor sem instalar Node.
macOS, Linux e Windows, x64 e arm64. No Windows, baixe o .exe do release.
curl -fsSL https://github.com/PiluVitu/Botai/releases/latest/download/install.sh | shBiblioteca
porta 06
O mesmo gerador no seu código JS ou TS, sem nenhuma dependência.
Node, Bun, Deno e navegador.
import { gerarPessoa } from '@pilutech/botai-core'gerarPessoa({ semente: 42, hoje: '2026-10-05' })Playwright
porta 07
A semente é o nome do teste: o retry usa a mesma pessoa e a falha leva a pessoa no relatório.
Chromium, Firefox e WebKit.
await botai.preencher(page)Motor
porta 08
Um script de 40 KB que preenche o formulário da página.
Qualquer ferramenta que execute JS na página. Testado com Playwright e CDP.
window.__botaiNavegador.preencher(document, pessoa, hoje, { segundaPassada: true })
Saída em JSON, NDJSON, CSV e SQL para Postgres, MySQL e SQLite. Importação provada no Postgres 16 e no SQLite.
Mesma pessoa
02Mesma semente, mesma pessoa.
Com a mesma semente e o mesmo hoje, toda porta que aceita semente devolve a mesma pessoa. O teste que falhou no CI roda na sua máquina com os mesmos dados.
Entrada
semente: 42hoje: '2026-10-05'No Playwright, a semente é o nome do teste.
- CLI
- HTTP
- Docker
- Binários
- Biblioteca
- Playwright
Saída
- nome
- Márcio Carvalho Rodrigues
- cpf
- 634.132.403-07
- celular
- (98) 97702-9128
- cep
- 65071-377 · São Luís, MA
- cnpj
- 90.849.558/0001-39
- cartão
- 5555 5555 5555 4444
a semente 42 é um dos 12 arquivos dourados
- 01 · no CI
O teste falha e o relatório leva a pessoa que foi usada, com a semente.
- 02 · na sua máquina
A mesma semente e o mesmo
hojeno terminal devolvem a mesma pessoa, campo por campo. - 03 · entre versões
Arquivos dourados guardam as pessoas esperadas de um conjunto de sementes e são conferidos a cada PR. Os 12 não mudaram da 0.2.0 à 0.4.1. Fixe a versão do pacote.
A pessoa
03Uma pessoa onde tudo bate.
A UF do endereço amarra o CPF, o DDD e o título. Todos os documentos passam no dígito verificador.
Márcio Carvalho Rodrigues
26/02/1970 · 56 anos
- CEP
- 65071-377
- Endereço
- Avenida Litorânea, 199, Apto 171 · Calhau · São Luís, MA
- CPF
- 634.132.403-07
- Celular
- (98) 97702-9128
- Título de eleitor
- 5022 4149 1171
- RG · PIS
- 92.957.904-5 · 166.24491.26-5
- marcio-rodrigues-0337@tuamaeaquelaursa.com
- Empresa
- Carvalho & Rodrigues Engenharia Ltda · Rodrigues Store · 90.849.558/0001-39
- Cartão de teste Stripe
- 5555 5555 5555 4444 · 11/28
- MA
CEP real
O CEP existe, e a rua, o bairro e a cidade batem com ele. A UF dele amarra o CPF, o DDD e o título.
- …3-07
CPF da região fiscal
O nono dígito é o da região fiscal da UF: 3 cobre CE, MA e PI.
- (98)
DDD do CEP
O celular usa o DDD daquele CEP.
- …11..
Título com o código da UF
O título de eleitor traz o código da UF, 11 para o Maranhão. RG e PIS também passam no dígito.
- @
E-mail do nome
Derivado do nome, com caixa de entrada pública para ler a confirmação.
Para quem
04Cada um entra pela sua porta.
QA manual
- extensão
- Um atalho preenche o cadastro inteiro, e a mesma pessoa fica guardada entre as etapas de um fluxo.
- Guarde até 3 pessoas favoritas, com apelido, e preencha com qualquer uma em
Botão direito › Botaí › Preencher com. Botão direito › Botaí › Inserirpõe CPF, e-mail, CEP e mais 20 tipos num campo só.- “Abrir caixa de entrada” abre a caixa pública, onde chega o e-mail de confirmação.
Dev frontend
- extensão
- biblioteca
- Funciona com React, Vue e máscaras (imask, jQuery Mask e maska).
- O popup lista os campos que não reconheceu.
- A biblioteca traz validadores de CPF, CNPJ, RG, PIS e título.
QA de automação
- playwright
- motor
botai.preencher(page)em cadastro, checkout e onboarding, em todos os frames.- A falha do CI é reproduzida com a mesma pessoa no terminal.
Backend semeando banco
- cli
- sql
- csv
- Mil INSERTs iguais em qualquer máquina, compatíveis com colunas UNIQUE.
--uf PIamarra o CEP, o DDD, a região do CPF e o código do título.
CI
- npx com versão fixa
- imagem
- binário
- O seed de banco num passo do workflow.
- A imagem entra como service container.
Não sabe por onde começar?
A documentação tem um guia por porta e as integrações por linguagem.
docs.botai.pilutech.com.br
Integrações
05O que foi testado, e o que ainda não.
O motor roda em qualquer ferramenta que execute JS na página, e o servidor atende qualquer linguagem que fale HTTP. O selo diz o que já tem teste.
Playwright
TestadoPostgres
TestadoSQLite
TestadoPython
Testado via HTTPNode
TestadoBun
TestadoDeno
TestadoCypress
Sem teste · JSSelenium
Sem teste · JSPuppeteer
Sem teste · JSWebdriverIO
Sem teste · JSGo
Sem teste · HTTPJava
Sem teste · HTTP
Extensão
06Bota aí no navegador.
Um atalho preenche a página inteira. O botão direito põe um dado num campo só. A mesma pessoa fica guardada até você pedir outra. Até 3 pessoas favoritas, cada uma com um apelido, voltam pelo popup ou pelo botão direito. O cartão de teste das próximas pessoas sai da Stripe ou da Pagar.me, no cenário que você escolher.
- Chrome Web Store
- Firefox Add-ons
- Opera em revisão
Chrome 123+ e Edge pela Chrome Web Store · Firefox 153+
| Sistema | Preencher a página |
|---|---|
| macOS | ⌥⇧P |
| Windows | Ctrl+Shift+Y |
| Linux | Ctrl+Shift+Y · Alt+Shift+P no Firefox |
| Um campo só | botão direito › Botaí › Inserir |



Privacidade e cuidados
07Fictício, mas com cuidado.
Privacidade
A extensão não tem servidor nem analytics e só age na aba em que você a aciona.
Política de privacidadeCuidados
- Os dados são fictícios, mas um CPF, CNPJ ou celular gerado pode pertencer a alguém de verdade.
- A caixa de e-mail é pública: quem souber o endereço lê as mensagens.
- Use só em localhost e em ambiente de teste.
Botaí no seu teste.
Comece pela porta que você já usa. A documentação tem o guia de cada uma.


