
auto-browser
github.com/ruvnet/auto-browser- Category
- AI Agents
- Rank
- No. 1682Tools index
Previous survey · No. 1687 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- ruvnet
- GitHub
- 99 stars
- Date
About
Command-line tool for configurable web automation with AI-assisted template creation — drive any site from a YAML config.
What it does
Auto-Browser turns a plain-English task into a headless browser session driven by an OpenAI-backed agent. It can navigate pages, extract requested content, perform interactions, reuse site templates, and save results as Markdown. An optional second model pass formats extracted material into a structured report.
Why it's ranked here
The core workflow is approachable and unusually broad, covering extraction, forms, multi-page tasks, templates, and reports through one CLI. The implementation weakens that promise: AI template analysis is discarded in favor of fixed finance-site selectors, so generated templates are not genuinely site-aware.
What's good
It closes the loop from task description to saved output. Browser sessions always close after work, templates use validated configuration models, existing template files can be extended, and Docker packages the browser-heavy dependency stack. Verbose output exposes generated selectors, raw extraction results, and processed content for debugging.
Tradeoffs
An OpenAI API key is mandatory, and browser tasks depend on model output rather than deterministic scripts. Interactive work may run a second agent over the same browser, increasing model usage. Headless mode is forced despite a documented environment setting. Installation guidance also conflicts with package metadata about the minimum supported Python version.
How to use it well
Use it for exploratory extraction, recurring site tasks, and browser workflows where natural-language convenience matters more than strict reproducibility. Prefer Docker, inspect verbose output, and hand-correct saved selectors before relying on templates. It does not replace deterministic browser tests, a general automation library, or a robust template generator in its current form.
Technical notes+
auto-browser/browser_automation/cli.py exposes the Click CLI, requires a loadable config before dispatch, creates AI-generated templates when no site is selected, and forces headless execution. auto-browser/browser_automation/browser.py wraps browser_use.Agent with ChatOpenAI, enables vision, and may launch a second agent for interactive actions. auto-browser/browser_automation/template_generator.py runs page analysis but _create_selectors ignores its analysis argument and returns fixed Google Finance selectors. auto-browser/setup.py declares Python >=3.11, while README.md says Python 3.8 or higher. auto-browser/browser_automation/processors/report.py adds another model call for report generation.
Observed
- License
- MIT
- Primary language
- Python
- Interface
- Command-line interface built with Click
- Packaging
- Setuptools package with an auto-browser script entry surface
- Installation
- Docker Compose, Docker image build, shell installer, or editable pip install
- Browser engine
- browser-use with a headless browser and vision-enabled OpenAI model agent
- Output
- Markdown files, with optional model-generated structured reports
- Platform support
- Docker is described as cross-platform; the quick installer targets Linux and macOS
Read from README.md, auto-browser/setup.py, demos/movie_reviews.py, auto-browser/browser_automation/cli.py, auto-browser/browser_automation/config.py, auto-browser/browser_automation/browser.py, auto-browser/browser_automation/__init__.py, auto-browser/browser_automation/content_processor.py, auto-browser/browser_automation/template_generator.py, auto-browser/browser_automation/prompts/__init__.py, auto-browser/browser_automation/processors/agent.py, auto-browser/browser_automation/processors/report.py, auto-browser/browser_automation/processors/content.py, auto-browser/browser_automation/formatters/__init__.py, auto-browser/browser_automation/processors/__init__.py.
What it can do
Automate web interactions from command line
YAML configuration file → Executed web automation tasks
Create automation templates with AI assistance
Natural language description of desired automation → YAML configuration template
Drive website navigation and interactions
Target website URL and automation instructions → Completed web actions (clicks, form fills, data extraction)
Extract data from web pages
Website URL and data selector configuration → Scraped web data
Fill and submit web forms automatically
Form data and target form configuration → Submitted form with confirmation
Configure custom automation workflows
YAML configuration with steps and conditions → Executable automation workflow
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.