Guide · Open source
How to use nopecha-extension: install and setup guide
Updated · written with AI from the project's own documentation and checked against our catalogue data
nopecha-extension is an open-source browser extension from NopeCHALLC that tries to solve CAPTCHA challenges automatically, so an automated browser session can keep moving without a person clicking through them. This guide is for developers and testers who run browser automation and want to understand what the extension needs, how to get the code, and where it fits. By the end you will know the prerequisites, the install step the README describes, and the limits to check before you rely on it.
NopeCHANopeCHALLC/nopecha-extension · ★ 11.1k · MIT Install options & downloads Quick start
- 1Check your browser. Confirm you have Chromium or Firefox installed, since these are the listed prerequisites.
- 2Clone the repository. Run git clone https://github.com/NopeCHALLC/nopecha-extension in the folder where you want the code.
- 3Read the documentation. Open the documentation and API reference linked from the project homepage to find the loading and setup steps.
- 4Load the extension in your browser. Follow the documented steps to load the extension into the browser your automation uses.
- 5Connect it to your automation tool. Set up Selenium, Puppeteer, or Playwright to run with the loaded extension, following the project's docs.
- 6Test on a site you are allowed to automate. Run a CAPTCHA demo or a site you control, and check the popup for solve status.
What nopecha-extension does
nopecha-extension is a browser extension that attempts to solve CAPTCHA challenges automatically. The README says it works with automation tools such as Selenium, Puppeteer, and Playwright.
The project describes its solving as relying on the NopeCHA service and its API, so it is not a fully offline tool. The project also links an API reference, documentation, a CAPTCHA demo page, and a developer Discord.
- Attempts to solve CAPTCHAs automatically in the browser
- Works with automation tools such as Selenium, Puppeteer, and Playwright, according to the README
- Release notes list support for several CAPTCHA types, including reCAPTCHA, Cloudflare Turnstile, PerimeterX, and AWS WAF
- Licensed under MIT
What you need before you install
The install method listed for this project is a downloaded app, and the prerequisite is a Chromium or Firefox browser. Make sure one of these is installed before you start.
Because solving depends on the NopeCHA service, the extension needs network access to that service to work. Check the project's documentation for any account or API key requirements, since the README excerpt does not cover them.
- A Chromium or Firefox browser
- Network access, because solving relies on the NopeCHA service and its API
- Git, if you want to clone the repository as the README shows
Get the nopecha-extension code
The README gives a clone command for the repository. Run it in the folder where you want the project to live.
The README badges also link to extension listings for Chrome Web Store and Mozilla Add-on. Those listings are an alternative way to get the extension if you do not want to work from the source.
git clone https://github.com/NopeCHALLC/nopecha-extensionLoad the extension and connect it to your automation
The README excerpt used for this guide does not show the exact steps for loading the extension into a browser or wiring it into Selenium, Puppeteer, or Playwright. Read the project's documentation at the homepage and the API reference before you write your own setup, so you do not rely on guessed steps.
Once the extension is loaded, the popup and settings let you control parts of its behaviour. Release notes mention a disabled hosts list, which lets you turn the extension off for specific sites, and configurable mouse speed and visualization.
- Read the documentation at https://nopecha.com/docs/ for loading and configuration steps
- Use the disabled hosts list to exclude sites you do not want the extension to act on
- Check the popup for solve status and pass-rate diagnostics, which release notes describe
Know the limits before you rely on it
Some features depend on the browser. Release notes say one mouse-action update applied to Chromium only, so check whether your target feature works in Firefox before you depend on it.
The README does not address whether solving CAPTCHAs is allowed on a given site. Only automate sites you have permission to test, and check their terms before you run the extension against them.
- Chromium-only behaviour is noted for some mouse actions
- The README does not cover site terms or permissions
- Solving depends on an online service, so it will not work offline
What people use it for
- Keeping an end-to-end test suite running when a staging site shows a CAPTCHA to automated browsers
- Testing how your own site's CAPTCHA challenges behave under automation
- Checking whether a Selenium, Puppeteer, or Playwright workflow reaches the pages it should after a challenge
- Comparing extension-based solvers against API-based approaches in a test environment
Frequently asked questions
Is nopecha-extension free?
The project is released under the MIT licence, according to the README. The solving relies on the NopeCHA service and its API, so check the homepage and documentation for any service terms that apply to that part.
What do I need to install nopecha-extension?
The listed prerequisite is a Chromium or Firefox browser. The README gives a git clone command for the repository, and the install method is listed as a downloaded app.
Which automation tools does nopecha-extension work with?
The README says it works with automation tools such as Selenium, Puppeteer, and Playwright. The excerpt does not list every supported tool, so check the documentation for details.
Which CAPTCHA types does nopecha-extension support?
Release notes mention reCAPTCHA, Cloudflare Turnstile, PerimeterX, and AWS WAF among supported types. Support can change between releases, so check the release notes for the version you use.
Does nopecha-extension work offline?
No. The solving relies on the NopeCHA service and its API, so it needs a network connection.
What are alternatives to nopecha-extension?
Projects listed as comparable include 2captcha-python, capsolver-extension, and anti-captcha-extension. Compare how each one handles your target CAPTCHA type, browser support, and licence before choosing.
New agent skills, repos and AI tools — every week
The best new skills and open-source projects, the fastest-growing repos, and one free prompt. Five minutes to read. Unsubscribe anytime.
Our verdict
nopecha-extension suits developers and testers who already use Selenium, Puppeteer, or Playwright and need a browser-extension solver for test environments or sites they are allowed to automate. It is a poor fit for anyone who needs an offline tool, a simple ad-blocker-style extension with no setup, or a way to get past CAPTCHAs on sites without permission.
Install options & downloads