JavaScript in-page GUI agent. Control web interfaces with natural language.

The GUI Agent Living in Your Webpage. Control web interfaces with natural language.

🌐 English | 中文

👉 🚀 Demo | 📖 Documentation | 📢 Join HN Discussion

• 🎯 Easy integration
  • No need for browser extension / python / headless browser.
  • Just in-page javascript. Everything happens in your web page.
  • The best tool for your agent to control web pages.
• 📖 Text-based DOM manipulation
  • No screenshots. No OCR or multi-modal LLMs needed.
  • No special permissions required.
• 🧠 Bring your own LLMs
• 🎨 Pretty UI with human-in-the-loop
• 🐙 Optional chrome extension for multi-page tasks.

• SaaS AI Copilot — Ship an AI copilot in your product in lines of code. No backend rewrite needed.
• Smart Form Filling — Turn 20-click workflows into one sentence. Perfect for ERP, CRM, and admin systems.
• Accessibility — Make any web app accessible through natural language. Voice commands, screen readers, zero barrier.
• Multi-page Agent — Extend your agent's reach across browser tabs with the optional chrome extension.

Fastest way to try PageAgent with our free Demo LLM:

<script src="{URL}" crossorigin="true"></script>

⚠️ For technical evaluation only. This demo CDN uses our free testing LLM API. By using it, you agree to its terms.

npm install page-agent

import { PageAgent } from 'page-agent'

const agent = new PageAgent({
    model: 'qwen3.5-plus',
    baseURL: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
    apiKey: 'YOUR_API_KEY',
    language: 'en-US',
})

await agent.execute('Click the login button')

For more programmatic usage, see 📖 Documentations.

We welcome contributions from the community! Follow our instructions in CONTRIBUTING.md for environment setup and local development.

Please read Code of Conduct before contributing.

This project builds upon the excellent work of browser-use.

PageAgent is designed for client-side web enhancement, not server-side automation.

DOM processing components and prompt are derived from browser-use:

Browser Use
Copyright (c) 2024 Gregor Zunic
Licensed under the MIT License

Original browser-use project: <https://github.com/browser-use/browser-use>

We gratefully acknowledge the browser-use project and its contributors for their
excellent work on web automation and DOM interaction patterns that helped make
this project possible.

Third-party dependencies and their licenses can be found in the package.json
file and in the node_modules directory after installation.

MIT License

⭐ Star this repo if you find PageAgent helpful!