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
- Install 64-bit Python 3.10 or newer on Windows x64, Apple Silicon macOS 26+, or Linux x86_64.
- Run
python -m pip install ruyijsin a terminal. - Check the install with
import ruyijsandprint(ruyijs.__version__). - Open a
Contextin Python and callcontext.evalto 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.
Ranking history
Official links
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.