Pular para o conteúdo
NovidadesIA

Projetos de Código Aberto

ruyiJS: Firefox headless puro para automação de IA em Python

cutetailbud lançou a ferramenta há 19 dias com 1.342 estrelas no GitHub

Edição: Anderson Gomes
· 3 min de leitura

ruyiJS: Firefox headless puro para automação de IA em Python
Imagem: Reprodução · site do ff-ruyijs · reprodução · licença AGPL-3.0

Quem precisa executar JavaScript de sites sem abrir um navegador completo tem no ruyiJS uma alternativa enxuta. A biblioteca Python da cutetailbud, lançada em 28 de outubro de 2026, já soma 1.342 estrelas no GitHub em apenas 19 dias. Ela embute o motor SpiderMonkey do Firefox 160 e a pilha de rede Necko, executando código e desafios anti-bot como um Firefox real — só sem interface gráfica. Ideal para quem automatiza coleta de dados ou precisa assinar scripts para agentes de IA sem carregar um navegador pesado.

Por dentro: SpiderMonkey puro com Necko

A ferramenta carrega apenas o necessário: o motor SpiderMonkey do Firefox 160 e a pilha de rede Necko. Não tem janela, não tem renderer, não tem GPU. Cada contexto roda em processo isolado, com seu próprio mundo JavaScript e proxy, garantindo que sessões não se misturem. As wheels pré-compiladas incluem o runtime SpiderMonkey + Necko, com cerca de 42 MB no Windows. No macOS ARM, usa libnecko_core.dylib e libnecko_quic.dylib vinculadas ao NSS do mesmo Firefox. No Linux x86_64, a wheel manylinux_2_39_x86_64 é um build nativo ELF, com dependências como fontconfig e FreeType.

A versão 0.4.0 trouxe Firefox 160.0 como base, com wheels construídas a partir do release oficial. No Windows, o Necko usa necko-standalone 0.8.3, com NSS 3.132 e Neqo 0.33.0. O User-Agent reportado é rv:160.0 … Firefox/160.0, com suporte a TLS 100–160 e padrão em 160. Corrigiu um bug crítico: requisições abortadas agora param a transferência (#43). Também acelerou a geometria após mudanças de estilo, reduzindo de 213 ms para 0,5 ms em testes com 1.500 irmãos. O pacote inclui verificações como ci/hello_check.py que compara contra um ClientHello capturado do Firefox 160.0.

Instala em um comando e roda offline

Instalar exige Python 3.10+ em Windows x64, macOS 26+ (Apple Silicon) ou Linux x86_64 com glibc 2.39+. O comando é direto: pip install --upgrade ruyijs. As wheels estão no PyPI para as três plataformas. Depois da instalação, scripts locais rodam offline sem baixar navegador. No macOS e Linux, há detalhes extras nos arquivos docs/macos.md e docs/linux.md. A documentação lista requisitos específicos: no Linux, por exemplo, é necessário glibc 2.39 ou superior, encontrado em Ubuntu 24.04, Debian 13 e Fedora 40.

O ruyiJS entrega apenas o motor e a rede, sem janela nem GPU. Isso o torna invisível para sistemas de detecção que reconhecem Chrome ou Chromium. A abordagem é minimalista: carrega scripts, executa desafios anti-bot e coleta assinaturas exatamente como o Firefox faria. Para automação de IA, é útil quando o agente precisa interagir com páginas que exigem execução de JavaScript ou superação de CAPTCHAs.

O projeto tem 19 dias, mas já soma 1.342 estrelas e 360 forks no GitHub. Tem 15 issues abertas e o último commit do dia 16/11/2026 acompanha a versão 0.4.0. A licença AGPL-3.0 permite uso livre e modificação, mas proíbe uso proprietário sem compartilhamento do código derivado. Não serve para quem extrai dados com um cliente HTTP simples. O README alerta: "Any form of brute-force reverse engineering is strictly rejected."

  • C++
  • AGPL-3.0
  • Projetos de Código Aberto
  • GitHub

Fonte: Repositório no GitHub · Como produzimos as matérias