Banana Browser

Stealth browser automation that bypasses bot detection.

Try It Now

npx banana-browser demo

That's it. Watch your browser pass every bot detection test.

What It Does

Banana Browser is a headless Chrome that's invisible to bot detection. It uses Patchright (an undetectable Playwright fork) to pass fingerprint checks, Cloudflare, and anti-bot systems that block regular automation tools.

Perfect for AI agents, web scraping, and automation that needs to look human.

Installation

Quick Install (recommended)

npm install -g banana-browser

The native Rust binary downloads automatically. Then install Chrome:

banana-browser install

One-liner Demo (no install needed)

npx banana-browser demo

From Source

git clone https://github.com/timothywangdev/banana-browser
cd banana-browser
npm install
npm run build:native   # Requires Rust

Quick Start

Run the Bot Detection Demo

banana-browser demo

Opens a browser, navigates to bot detection tests, and shows you the results in your terminal.

Start the Browser Daemon

banana-browser start

Navigate to a URL

banana-browser open https://example.com

Take a Screenshot

banana-browser screenshot https://example.com -o screenshot.png

Check Your Setup

banana-browser --version

Features

• Undetectable - Passes Cloudflare, DataDome, PerimeterX, and fingerprint tests
• Fast - Native Rust CLI, no Node.js runtime overhead for the daemon
• Simple - Single binary, zero configuration required
• AI-Ready - Built for AI agents with structured output and MCP integration
• Cross-Platform - Works on macOS (Intel + ARM), Linux, and Windows

Comparison: Regular Automation vs Banana Browser

| Bot Detection Test | Puppeteer | Playwright | Banana Browser | |--------------------|-----------|------------|----------------| | navigator.webdriver | FAIL | FAIL | PASS | | Chrome headless detection | FAIL | FAIL | PASS | | Fingerprint consistency | FAIL | FAIL | PASS | | Cloudflare challenge | FAIL | FAIL | PASS | | DataDome | FAIL | FAIL | PASS |

CLI Commands

Core Commands

| Command | Description | |---------|-------------| | banana-browser demo | Run bot detection tests and show results | | banana-browser install | Install Chromium for automation | | banana-browser open <url> | Navigate to a URL | | banana-browser screenshot [path] | Take a screenshot | | banana-browser close | Close the browser | | banana-browser --version | Show version info | | banana-browser --help | Show all commands |

Interaction Commands

| Command | Description | |---------|-------------| | banana-browser click <selector> | Click an element | | banana-browser fill <selector> <text> | Fill a form field | | banana-browser type <text> | Type text into focused element |

Demo Options

| Option | Description | |--------|-------------| | --headless | Run demo in headless mode | | --quiet | Suppress promotional output | | --screenshot <path> | Save screenshot of results |

Environment Variables

| Variable | Description | |----------|-------------| | AGENT_BROWSER_ENGINE=patchright | Use Patchright anti-detection engine | | AGENT_BROWSER_HEADLESS=true | Run in headless mode |

Examples

# Run the bot detection demo
banana-browser demo

# Open a page with anti-detection
AGENT_BROWSER_ENGINE=patchright banana-browser open https://bot.sannysoft.com

# Automate a form
banana-browser open https://example.com/form
banana-browser fill "#email" "[email protected]"
banana-browser fill "#password" "secret"
banana-browser click "button[type=submit]"
banana-browser screenshot result.png

Documentation

• Full Documentation
• MCP Skills Guide
• API Reference

Contributing

We welcome contributions! See CONTRIBUTING.md for guidelines.

git clone https://github.com/timothywangdev/banana-browser
cd banana-browser
npm install
npm run dev:setup

License

Apache-2.0 - See LICENSE for details.