autopattern 0.2.3

Record and automate browser workflows with AI. Chat-based CLI + API server powered by Gemini and browser-use.

⚡ 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

Command	Description
(any text)	Run as a browser automation task
/load <file.csv>	Load a recorded workflow CSV
/model [name]	Show or change the Gemini model
/headless [on|off]	Toggle headless browser mode
/history	Show tasks run this session
/help	Show all commands
/quit	Exit
Ctrl+C	Stop a running task

---

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):

Endpoint	Method	Description
/api/health	GET	Health check
/api/settings	GET/PUT	View or update settings
/api/describe	POST	Analyze workflow events → structured steps
/api/automate	POST	Run automation from recorded events
/api/automate/task	POST	Run automation from a task description

---

Development

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

---

License

MIT — see LICENSE.