Installation

Install Human Browser

Human Browser is a free, open-source Playwright wrapper with residential proxy support. The script installs in seconds — pick your method below.

⭐ Recommended · OpenClaw

AI Agent Install

clawhub install human-browser
Installs skill + full context for AI agents. Tap to copy.
npm

Node.js / npm

npm install human-browser
Works in any Node.js project. Tap to copy.
skild.sh · Multi-platform

Claude, Cursor, Copilot

skild install al1enjesus/human-browser
Works across all major AI coding tools. Tap to copy.
GitHub

Clone / Fork

git clone https://github.com/al1enjesus/human-browser
Full source code. MIT license. Tap to copy.

Prerequisites

  1. Node.js 18+Check with node --version
  2. Install Playwright + Chromiumnpm install playwright && npx playwright install chromium --with-deps
  3. Get residential proxy credentialsPurchase at humanbrowser.dev — from $13.99/mo. Credentials arrive automatically after payment.
  4. Add credentials to your environmentPROXY_USER=... PROXY_PASS=... PROXY_HOST=brd.superproxy.io PROXY_PORT=22225

Quick start

const { launchHuman } = require('human-browser');

// Romania residential IP + iPhone 15 Pro fingerprint (default)
const { browser, page, humanType, humanScroll } = await launchHuman();

await page.goto('https://instagram.com', { waitUntil: 'domcontentloaded' });
await humanScroll(page, 'down');

// US residential IP + desktop Chrome fingerprint
const { page: usPage } = await launchHuman({ country: 'us', mobile: false });

// All supported options:
// country: 'ro' | 'us' | 'gb' | 'de' | 'nl' | 'jp' | 'fr' | 'ca' | 'sg' | 'au'
// mobile: true (iPhone 15 Pro) | false (Windows Chrome)

Works with

OpenClaw
Claude Code
Cursor
GitHub Copilot
Docker
GitHub Actions
Railway
Render
Any Linux VPS
LangChain
AutoGPT
Vercel (Serverless)

FAQ

Is Human Browser free?

The script is 100% free and MIT-licensed. The paid part is the residential proxy credentials ($13.99/mo Starter) — a real home IP address that gets you past bot detection.

Does Human Browser work without a proxy?

The script itself works, but without a residential proxy your server's data center IP will be blocked by Cloudflare, Instagram, etc. The proxy is what makes it actually bypass detection.

How is Human Browser different from Playwright-stealth or puppeteer-extra?

Those plugins only handle fingerprint flags inside the browser. Human Browser also fixes the IP layer (residential proxy), adds human-like mouse/typing behavior, and is packaged as an AI agent skill. It's the complete solution.

Where are the proxy credentials stored?

In your environment variables. Human Browser reads PROXY_USER, PROXY_PASS, PROXY_HOST, PROXY_PORT from process.env. If you bought via the agent API, they're delivered via webhook.

Ready to install Human Browser?

Script is free. Residential proxy from $13.99/mo. Get started in under 5 minutes.

Get Proxy Credentials → View on GitHub