⚡ AutoPattern

Record browser workflows, replay them with AI.

AutoPattern records your clicks, inputs and navigation in Chrome, then uses Google Gemini + browser-use to replay them autonomously. It ships as a single CLI command with a built-in API server for the companion Chrome extension.

Installation

pip install autopattern

Then install the browser driver (one-time):

playwright install chromium

Configuration

Set your Google Gemini API key (get one free):

export GOOGLE_API_KEY="your-key-here"

Or create a .env file in your working directory:

GOOGLE_API_KEY=your-key-here

Quick Start

Just run:

autopattern

This starts:

• An interactive chat where you type browser tasks in plain English
• A background API server on port 5001 for the Chrome extension

╭────────────────────────────────────────────╮
│          ⚡ AutoPattern v0.2.2              │
│   AI-powered browser automation from CLI   │
╰────────────────────────────────────────────╯

  📡 API server  : http://localhost:5001
  🤖 LLM model   : gemini-flash-latest

you > Go to github.com and star the autopattern repo
  🚀 Starting automation...
  ✅ Task completed successfully!

you > /quit

Chat Commands

CLI Modes

# Interactive chat + API server (default)
autopattern

# Run a single task
autopattern --task "Search Google for 'Python tutorials'"

# Replay a recorded workflow CSV
autopattern --workflow recording.csv

# API server only (no chat)
autopattern --server

# Custom port
autopattern --port 8000

As a Library

from automation import AutomationRunner

runner = AutomationRunner(headless=False)
result = runner.run_task_sync("Go to google.com and search for Python")
print(result["success"])

Chrome Extension

The companion Chrome extension records your browser interactions and sends them to AutoPattern's API for replay. Install it from the extension/ directory in the source repo.

API Endpoints

When AutoPattern is running (via autopattern or autopattern --server):

Development

git clone https://github.com/autopattern/autopattern.git
cd autopattern/backend
pip install -e ".[dev]"
playwright install chromium

License

MIT — see LICENSE.