https://github.com/jonymusky/ai-browser-automation

AI-powered browser automation using Selenium WebDriver
https://github.com/jonymusky/ai-browser-automation

ai automation llm selenium selenium-webdriver

Last synced: 4 months ago
JSON representation

AI-powered browser automation using Selenium WebDriver

• Host: GitHub
• URL: https://github.com/jonymusky/ai-browser-automation
• Owner: jonymusky
• License: mit
• Created: 2024-12-13T14:03:11.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2024-12-17T15:47:19.000Z (over 1 year ago)
• Last Synced: 2025-10-26T22:33:28.287Z (8 months ago)
• Topics: ai, automation, llm, selenium, selenium-webdriver
• Language: TypeScript
• Homepage:
• Size: 313 KB
• Stars: 1
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Contributing: CONTRIBUTING.md
  • License: LICENSE
  • Code of conduct: CODE_OF_CONDUCT.md
  • Security: SECURITY.md

Awesome Lists containing this project

README

          
# AI Browser Automation

![Tests](https://github.com/jonymusky/ai-browser-automation/workflows/Tests/badge.svg)

![Lint](https://github.com/jonymusky/ai-browser-automation/workflows/Lint/badge.svg)

![npm version](https://img.shields.io/npm/v/ai-browser-automation.svg)

[![NPM Downloads](https://img.shields.io/npm/dt/ai-browser-automation.svg?style=flat)](https://www.npmjs.com/package/ai-browser-automation)

A TypeScript package that combines Selenium WebDriver with AI capabilities for intelligent browser automation.

## Overview

This package provides an easy way to automate browser interactions using AI capabilities. It supports multiple LLM providers (OpenAI, Ollama) and can automatically detect and interact with web elements.

For a detailed list of changes and versions, see our [Changelog](CHANGELOG.md).

## Features

- Selenium-based browser automation

- AI-powered element detection and interaction

- Support for multiple LLM providers (OpenAI, Ollama, Grok)

- Screenshot capture capability

- Flexible step-based automation configuration

## Installation

```bash

npm install ai-browser-automation

# or

pnpm add ai-browser-automation

```

## Usage

```typescript

import { AiBrowserAutomation } from 'ai-browser-automation';

const automation = new AiBrowserAutomation({

  llmProvider: 'OpenAI',

  apiKey: 'your-api-key',

  browser: 'chrome',

  headless: true

});

const steps = [

  {

    action: 'navigate',

    description: 'Go to Google',

    url: 'https://google.com'

  },

  {

    action: 'write',

    description: 'Search for something',

    solve_with_ai: true

  }

];

const result = await automation.execute(steps);

```

## Examples

For detailed examples with screenshots and execution outputs, see our [Examples Documentation](docs/examples.md).

## Running an example

You can find example scripts in the `examples` directory. To run a specific example:

```bash

pnpm run-example google

```