Botaí

~/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-05
Exemplo: a pessoa da semente 42 no terminal
~/pilulabs/botaiterminal
npx @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" }, …}}
Exemplo: um cadastro preenchido pela extensão
localhost:3000/cadastroAtalho da extensão: Ctrl+Shift+Y

Criar conta

Nome completoMárcio Carvalho Rodrigues
E-mailmarcio-rodrigues-0337@tuamaeaquelaursa.com
CPF634.132.403-07
Celular(98) 97702-9128
CEP65071-377
CidadeSão Luís · MA

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

01

Um 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 Linux
  • CLI

    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.0
  • Biná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 | sh
  • Biblioteca

    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

02

Mesma 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

  1. 01 · no CI

    O teste falha e o relatório leva a pessoa que foi usada, com a semente.

  2. 02 · na sua máquina

    A mesma semente e o mesmo hoje no terminal devolvem a mesma pessoa, campo por campo.

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

03

Uma 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

semente 42
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
E-mail
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

04

Cada 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í › Inserir põ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 PI amarra 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

05

O 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

    Testado
  • Postgres

    Testado
  • SQLite

    Testado
  • Python

    Testado via HTTP
  • Node

    Testado
  • Bun

    Testado
  • Deno

    Testado
  • Cypress

    Sem teste · JS
  • Selenium

    Sem teste · JS
  • Puppeteer

    Sem teste · JS
  • WebdriverIO

    Sem teste · JS
  • Go

    Sem teste · HTTP
  • Java

    Sem teste · HTTP

Extensão

06

Bota 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 123+ e Edge pela Chrome Web Store · Firefox 153+

Atalhos por sistema
SistemaPreencher a página
macOS⌥⇧P
WindowsCtrl+Shift+Y
LinuxCtrl+Shift+Y · Alt+Shift+P no Firefox
Um campo sóbotão direito › Botaí › Inserir
Formulário de cadastro preenchido pelo Botaí, com o popup mostrando 12 de 14 campos preenchidos (tema claro)
O popup mostra quantos campos entraram e lista os que ficaram de fora.
Popup do Botaí com 3 pessoas favoritas, cada uma com o seu apelido, e a ativa marcada com a estrela (tema claro)
Até 3 pessoas favoritas, cada uma com um apelido, voltam pelo popup ou pelo botão direito.
Popup do Botaí com o cartão de teste da Pagar.me no cenário recusado e a escolha do provedor e do cenário das próximas pessoas (tema claro)
O cartão das próximas pessoas sai da Stripe ou da Pagar.me, no cenário que você escolher.

Privacidade e cuidados

07

Fictí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 privacidade

Cuidados

  • 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.
Termos de uso

Botaí no seu teste.

Comece pela porta que você já usa. A documentação tem o guia de cada uma.