Browserable

Website | Documentation | Discord | Twitter

Open source browser automation library for AI agents

Browserable allows you to build browser agents that can navigate sites, fill out forms, clicking buttons and extract information. It is currently at 90.4% on the Web Voyager benchmarks.

Quick start

The fastest way to get started is to run the npx command. This will guide you through the setup process and ensure you have all required dependencies.

npx browserable

Visit http://localhost:2001 to set your LLM and Remote Browser API Keys to start using.

Manual setup

Clone the repository:

```bash

git clone https://github.com/browserable/browserable.git cd browserable

```

Pre-requisites:

• Install Docker
• Install Docker Compose

Start the development environment:

```bash

cd deployment docker-compose -f docker-compose.dev.yml up

```

Set your API keys:

• Open Browserable admin dashboard: http://localhost:2001/dash/@admin/settings.
• Set API key of any one LLM provider (Gemini/ Open AI/ Claude).
• Sign up for a free plan with any one remote browser provider (Hyperbrowser/ Steel).
• Set the API key of the remote browser provider in your Browserable admin dashboard.

Services

Once running, you'll have access to the following services:

JavaScript SDK

Install the SDK using npm:

npm install browserable-js

Or using yarn:

yarn add browserable-js

Here’s a simple example to get you started:

import { Browserable } from 'browserable-js';

// Initialize the SDK
const browserable = new Browserable({
  apiKey: 'your-api-key'
});

// Create and run a task
async function runTask() {
  const createResult = await browserable.createTask({
    task: 'Find the top trending GitHub repos of the day.',
    agent: 'BROWSER_AGENT'
  });

  // Wait for task completion
  const result = await browserable.waitForRun(taskId);
  console.log('Results:', result.data);
}

Demos