Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/alibaba/page-agent

JavaScript in-page GUI agent. Control web interfaces with natural language.
https://github.com/alibaba/page-agent

agent ai ai-agents browser-automation javascript typescript ui-automation web

Last synced: 2 months ago
JSON representation

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

Awesome Lists containing this project

README 

          
# Page Agent



  

  Page Agent Banner



[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/%3C%2F%3E-TypeScript-%230074c1.svg)](http://www.typescriptlang.org/) [![Downloads](https://img.shields.io/npm/dt/page-agent.svg)](https://www.npmjs.com/package/page-agent) [![Bundle Size](https://img.shields.io/bundlephobia/minzip/page-agent)](https://bundlephobia.com/package/page-agent) [![GitHub stars](https://img.shields.io/github/stars/alibaba/page-agent.svg)](https://github.com/alibaba/page-agent)



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



🌐 **English** | [中文](./docs/README-zh.md)



👉 🚀 Demo | 📖 Documentation | 📢 Join HN Discussion | 𝕏 Follow on X



---



## ✨ Features



- **🎯 Easy integration**

    - No need for `browser extension` / `python` / `headless browser`.

    - Just in-page javascript. Everything happens in your web page.

- **📖 Text-based DOM manipulation**

    - No screenshots. No multi-modal LLMs or special permissions needed.

- **🧠 Bring your own LLMs**

- **🎨 Pretty UI with human-in-the-loop**

- **🐙 Optional [chrome extension](https://alibaba.github.io/page-agent/docs/features/chrome-extension) for multi-page tasks.**



## 💡 Use Cases



- **SaaS AI Copilot** — Ship an AI copilot in your product in lines of code. No backend rewrite.

- **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 own agent's reach across browser tabs with the optional [chrome extension](https://alibaba.github.io/page-agent/docs/features/chrome-extension).



## 🚀 Quick Start



### One-line integration



Fastest way to try PageAgent with our free Demo LLM:



```html



```



> **⚠️ For technical evaluation only.** This demo CDN uses our free [testing LLM API](https://alibaba.github.io/page-agent/docs/features/models#free-testing-api). By using it, you agree to its [terms](https://github.com/alibaba/page-agent/blob/main/docs/terms-and-privacy.md).



| Mirrors | URL                                                                                |

| ------- | ---------------------------------------------------------------------------------- |

| Global  | https://cdn.jsdelivr.net/npm/page-agent@1.5.7/dist/iife/page-agent.demo.js         |

| China   | https://registry.npmmirror.com/page-agent/1.5.7/files/dist/iife/page-agent.demo.js |



### NPM Installation



```bash

npm install page-agent

```



```javascript

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](https://alibaba.github.io/page-agent/docs/introduction/overview).



## 🤝 Contributing



We welcome contributions from the community! Follow our instructions in [CONTRIBUTING.md](CONTRIBUTING.md) for setup and guidelines.



Please read [Code of Conduct](docs/CODE_OF_CONDUCT.md) before contributing.



Contributions generated entirely by bots or agents without substantial human involvement will not be accepted, and bot accounts may be blocked.



## 👏 Acknowledgments



This project builds upon the excellent work of **[`browser-use`](https://github.com/browser-use/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



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.

```



## 📄 License



[MIT License](LICENSE)



---



**⭐ Star this repo if you find PageAgent helpful!**





 

   

   

   Star History Chart