Repolode
mherrmann

mherrmann/helium

Biblioteca Python para automação de navegadores baseada em Selenium, que permite encontrar elementos por rótulos visíveis em vez de seletores.

Estrelas
8,322
Forks
513
Issues abertas
55
Último commit
há 3 dias

O que é?

Helium é uma biblioteca Python para automatizar o Chrome e o Firefox. Ela encapsula o Selenium e encaminha cada chamada para ele, mantendo o driver subjacente disponível para que os dois possam ser usados livremente no mesmo script.

A principal diferença está na API. Em vez de IDs HTML, XPaths ou seletores CSS, o Helium identifica elementos por rótulos visíveis para o usuário, como Button('Download'). Em geral, os scripts ficam 30–50% mais curtos do que o código equivalente em Selenium e têm menos chances de quebrar quando a marcação da página muda.

O Helium também facilita várias tarefas complicadas no Selenium puro: interage com elementos dentro de iframes aninhados sem precisar alternar para eles, coloca popups em foco quando abrem e fecham, alterna entre janelas pelo título parcial e aguarda implicitamente até 10 segundos para os elementos aparecerem. Também oferece um helper wait_until mais simples para esperas explícitas.

Recursos principais

  • 01Localiza elementos por rótulos visíveis, como os de botões e links, em vez de seletores.
  • 02Funciona com Chrome e Firefox por meio do Selenium.
  • 03Interage com elementos em iframes aninhados sem alternar explicitamente para eles.
  • 04Lida automaticamente com janelas popup e alterna entre janelas pelo título parcial.
  • 05Aguarda até 10 segundos por padrão para os elementos aparecerem.
  • 06Permite combinar chamadas do Helium com APIs brutas do Selenium no mesmo script.

Casos de uso

  • Automatizar tarefas repetitivas na web, como preencher formulários ou baixar relatórios.
  • Escrever testes de navegador legíveis e resistentes a mudanças na marcação.
  • Extrair dados de páginas em que é mais fácil identificar os elementos pelo texto visível.

Início rápido

  1. 1

    Criar um ambiente virtual

    python3 -m venv venv
  2. 2

    Ativar o ambiente virtual (Mac/Linux)

    source venv/bin/activate
  3. 3

    Instalar o Helium com pip

    python -m pip install helium

Antes de usar

  • É necessário ter o Chrome ou o Firefox instalado.
  • O mantenedor tem pouco tempo e geralmente não responderá a issues, a menos que sejam fáceis de resolver.

Em coleções

Tópicos

Perguntas frequentes

O que é helium?
Biblioteca Python para automação de navegadores baseada em Selenium, que permite encontrar elementos por rótulos visíveis em vez de seletores. Helium é uma biblioteca Python para automatizar o Chrome e o Firefox. Ela encapsula o Selenium e encaminha cada chamada para ele, mantendo o driver subjacente disponível para que os dois possam ser usados livremente no mesmo script.
helium é gratuito? Qual é a licença?
helium é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
helium ainda é mantido?
Manutenção ativa. O último commit de helium foi em 22 de out. de 2026.
Para que posso usar helium?
Automatizar tarefas repetitivas na web, como preencher formulários ou baixar relatórios. Escrever testes de navegador legíveis e resistentes a mudanças na marcação. Extrair dados de páginas em que é mais fácil identificar os elementos pelo texto visível.
Como instalar helium?
Criar um ambiente virtual: python3 -m venv venv Ativar o ambiente virtual (Mac/Linux): source venv/bin/activate Instalar o Helium com pip: python -m pip install helium
Onde consigo helium?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/mherrmann/helium

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados