🌐 OpenFlow (webagent)

Open-Source AI Web Automation & Scraping Platform

Transform plain English instructions into Playwright web automation scripts & visual browser replays.

Stop writing fragile CSS selectors manually. Describe any web workflow in plain English and let OpenFlow replay actions visually and export production Playwright scripts.

Quickstart · Features · Architecture · CLI Usage

---

🌟 Overview

Web scraping and Robotic Process Automation (RPA) are evolving from brittle static scripts toward autonomous vision-based AI agents.

OpenFlow is an open-source platform inspired by Playwright, Firecrawl, and Dify. It allows developers to specify web tasks ("Log into dashboard, extract table rows, and save screenshot"), visually watch action steps execute in a live browser viewport, and export production-ready Python and TypeScript Playwright code.

---

✨ Key Features

• 🌐 Visual Live Browser Viewport: Replay autonomous browser steps (URL navigation, element clicks, form typing, table data extraction) in real time.
• ⚡ Natural Language Task Decomposition: Automatically parses prompt workflows into structured Playwright actions (goto, type, click, extract_table, screenshot).
• 🛠️ Multi-Language Code Exporter:
  • 🐍 Python (playwright.async_api)
  • ⚡ TypeScript / Node.js (@playwright/test)
• 🛡️ Stealth & Anti-Bot Profile Manager: Configure Playwright stealth plugins, user-agent overrides, and proxy rotation profiles.
• 💻 Executable CLI (webagent): Launch the workspace instantly using npx openflow.

---

🏗️ Architecture

graph TD
    A["🌐 Natural Language Web Task"] --> B["🧠 Workflow Engine (workflowEngine)"]
    
    B --> C1["🌐 Visual Browser Viewport"]
    B --> C2["📋 Action Step Log"]

    C1 & C2 --> D["⚡ Playwright Code Synthesizer (scriptExporter)"]

    D --> E1["🐍 Python (async_playwright)"]
    D --> E2["⚡ TypeScript (@playwright/test)"]

    B --> F["🛡️ Stealth & Anti-Bot Evasion Profile"]

Loading

---

🚀 Quickstart

Option 1: Run via npx

npx openflow

Option 2: Clone & Run Locally

# Clone repository
git clone https://github.com/Nithinfgs/openflow.git
cd openflow

# Install dependencies
npm install

# Start development dashboard
npm run dev

Open http://localhost:3004 in your browser.

---

💻 CLI Usage

# Launch interactive dashboard
openflow

# Custom port
openflow --port 8080

# View help
openflow --help

---

📄 License

Distributed under the MIT License. See LICENSE for details.

_{Maintained by @Nithinfgs and the Web Automation Open Source Community.}