Documentação Minima

Bem-vindo à documentação oficial do Minima!

O Minima é um framework de automação de UI altamente semântico e abstraído, construído sobre o Selenium. Ele foi projetado com a filosofia de que o código de automação deve ser intuitivo, profundamente legível e otimizado tanto para desenvolvedores humanos quanto para Grandes Modelos de Linguagem (LLMs).

A Filosofia

Ao separar as entradas humanas (teclado e mouse) do motor principal do navegador, o Minima permite que os desenvolvedores criem scripts robustos que são fáceis de ler, manter e escalar. Além disso, o Minima reduz drasticamente o boilerplate estrutural típico dos scripts Selenium.

“Leitura e escrita para Humanos e LLMs” Como o Minima utiliza uma sintaxe altamente semântica, ele requer até 40% menos tokens para expressar lógicas complexas em comparação com o Selenium puro. Isso resulta em uma geração de scripts por LLMs mais econômica, inferência de IA mais rápida e uma carga cognitiva drasticamente reduzida para mantenedores humanos.

Estrutura da Documentação

• Primeiros Passos: Instalação, configuração e seu primeiro script Minima.

• Referência da API: Detalhamento dos elementos de UI, entradas e decoradores de sessão de navegador do Minima.

• Hipótese de Economia de Tokens: Leia a tese sobre como o Minima reduz o overhead de tokens de LLM e maximiza a legibilidade.

Arquitetura do Projeto

O Minima é construído com uma separação rigorosa de preocupações:

minima/
├── engine/             # Lógica Principal do Selenium e Gestão de Contexto
│   ├── context.py      # Gestão de sessão (@browser_session)
│   └── controller.py   # BrowserController
├── input/              # Simulação de Entrada
│   ├── keyboard.py     # Mapeamentos de teclado
│   └── mouse.py        # Ações de mouse
├── ui/                 # Camada de Widget de UI Semântica
│   ├── ui_element.py   # Interação base de elementos
│   ├── button.py       # Elementos de botão
│   ├── dropdown.py     # Elementos de seleção (select)
│   └── ...             # Inputs, Textos, Links, Imagens
├── settings/           # Configuração
└── logs/               # Rastreabilidade e Logs

Mergulhe no guia de Primeiros Passos para começar a automatizar sem esforço!