alibaba /page-agent
JavaScript in-page GUI agent. Control web interfaces with natural language.
★ 29,692⑂ 2,644👁 107⑃ 486● 224▤ 39
+4
Daily
+66
Weekly
+274
Monthly
29,692
stars
2,644
forks
107
watchers
486
prs
224
issues
39
releases
README
Page Agent
The GUI Agent Living in Your Webpage. One script gives any web page its own AI agent.
🌐 English | 中文
🚀 Demo | 📖 Docs | 📢 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
- Works with most mainstream models, including locally deployed ones. See supported models.
- 🐙 Optional chrome extension for multi-page tasks.
- And an MCP Server (Beta) to control it from outside
💡 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 web agent's reach across browser tabs via the Chrome extension.
- MCP - Allow your agent clients to control your browser.
🚀 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. By using it, you agree to its terms.
Add ?autoInit=false to load the script without creating the demo agent automatically. You can then instantiate it with new window.PageAgent(...) and your own LLMs.
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.
🤝 Contributing
We welcome contributions from the community! See CONTRIBUTING.md for guidelines and docs/developer-guide.md for local development workflows.
Built something cool with PageAgent? Share it in Show and Tell. 🙌
Please read the maintainer's note on principles and current state.
Contributions generated entirely by bots or AI without substantial human involvement will not be accepted.
⚖️ License
MIT License
👏 Acknowledgments
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
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.
⭐ Star this repo if you find PageAgent helpful!Top issues
#272🗺️ Roadmap v2 (WIP)16 comments · 2026-03-16#290[Bug] 一直无法选中antd的下拉选择,试过好多次还是不能选中10 comments · 2026-03-18#112Loop detection (same action has been called over and over again)9 comments · 2026-01-15#222[Feature] Can we add a hover action? / 能否增加一个鼠标悬停的动作6 comments · 2026-03-12#562[Bug] 大家真的有在使用吗?5 comments · 2026-06-22#467[Bug] 连input按钮都找不出来5 comments · 2026-04-21#622Your project is on StackMap — a curated map of the AI stack4 comments · 2026-07-15#572[Feature] 咨询:PageAgent 是否有针对 Vue 等 MVVM 架构的适配方案或规划4 comments · 2026-06-24
Discussions
#736是否能加入JEV模型,让决策效率变得更快!操作浏览器的速度大幅度增强?0 comments · 2026-09-23#691Sumlyzer: improve feedback loop for npm workspaces0 comments · 2026-09-01#688制作了网页插件使其可以跳转多个网页,变为更简便的agent0 comments · 2026-08-28#631操作手册0 comments · 2026-07-22#589Its in the future can be add more than 1 models and provider?0 comments · 2026-07-05#574Mindset over matter1 comments · 2026-06-25#381[Feature] 希望补充文档:如何在已有的插件中引入page-agent的插件1 comments · 2026-04-01#368想要了解下,下载项目后 集成后只能控制当前页面元素,无法进行新开页面,因为我想实现web ui自动化测试,操作数据想要存储1 comments · 2026-03-30
Latest release
🌟v1.12.4 v1.12.4 2026-09-06What's Changed feat: update models by @gaomeng1900 in https://github.com/alibaba/page-agent/pull/713 chore: fix size badge by @gaomeng1900 in https://github.com/alibaba/page-agent/pull/714 Full Changelog: https://github.com/alibaba/page-agent/compare/v1.12.3...v1.12.4