ruyiJS

ruyiJS is a Python library that runs a website's JavaScript in a windowless Firefox engine for developers and AI agents doing web scraping.

What it is good for

  • Collecting data from websites that run JavaScript checks
  • Running a site's scripts from Python without a full browser
  • Replaying a captured web session offline for testing

At a glance

Who it is for
Setup difficulty
Developer ยท Requires programming

Level 5 of 5. You need to write code to use it.

Cost
Free and open source
Type
Framework or SDK
Tasks
Works with
Python, Codex, Claude Code, Firefox

How to get started with ruyiJS

  1. Install 64-bit Python 3.10 or newer on Windows x64, Apple Silicon macOS 26+, or Linux x86_64.
  2. Run python -m pip install ruyijs in a terminal.
  3. Check the install with import ruyijs and print(ruyijs.__version__).
  4. Open a Context in Python and call context.eval to run JavaScript.

From the project's own documentation. If a step does not match what you see, the official pages have the latest instructions.

Before you try it

  • Using it requires writing Python code.
  • Needs Python 3.10+ on Windows x64, macOS 26+ on Apple Silicon, or Linux with glibc 2.39+.
  • Licensed under AGPL-3.0; closed-source or proprietary use needs a commercial license.
  • The disclaimer rejects brute-force reverse engineering; it is meant for researching AI browsers.

Momentum

Rank this week
#14 in builder tools
Best rank
#4 week 45, 2026
Stars gained last week
+225
GitHub stars
1,317

GitHub numbers as of Nov 16, 2026. Updated weekly.

461 921 1,380 Nov 2, 2026 Nov 16, 2026
GitHub stars for ruyiJS: 524 on Nov 2, 2026, 1,317 on Nov 16, 2026. Source: GitHub.

Ranking history

First ranked in week 45, 2026.

Questions

Is ruyiJS free?
Yes. It is free and open source (AGPL-3.0 license).
Do I need to know how to code to use ruyiJS?
Yes. You need to write code to use it.
What does ruyiJS work with?
According to its own documentation, it works with Python, Codex, Claude Code, and Firefox.
How do I get started with ruyiJS?
1. Install 64-bit Python 3.10 or newer on Windows x64, Apple Silicon macOS 26+, or Linux x86_64. 2. Run python -m pip install ruyijs in a terminal. 3. Check the install with import ruyijs and print(ruyijs.__version__). 4. Open a Context in Python and call context.eval to run JavaScript.
What should I know before trying ruyiJS?
Using it requires writing Python code. Needs Python 3.10+ on Windows x64, macOS 26+ on Apple Silicon, or Linux with glibc 2.39+. Licensed under AGPL-3.0; closed-source or proprietary use needs a commercial license. The disclaimer rejects brute-force reverse engineering; it is meant for researching AI browsers.
What is ruyiJS good for?
Collecting data from websites that run JavaScript checks, running a site's scripts from Python without a full browser, and replaying a captured web session offline for testing.

Similar agents to ruyiJS

  • camofox-browser

    Runs as a stealth browser server for AI agents instead of a Python library embedding Firefox's engine.

  • Scrapling

    A broader scraping framework with an MCP server, rather than a headless engine for running site JavaScript.

  • SeleniumBase

    Drives full browsers for testing and stealth browsing, not a windowless engine without a renderer.

  • Stagehand

    Scripts AI browser agents that click and read pages in a full browser.

  • Firecrawl

    A web data API that returns clean page content, so there is no engine to run locally.

  • stealth-browser-mcp

    stealth-browser-mcp is an MCP server (a connector that lets AI apps like Claude use another tool) that lets agents browse sites with anti-bot checks.

Last updated Nov 16, 2026. Tracked since Nov 2, 2026. Parts of this summary required judgment because the source material was brief. Spotted an error? Tell us.