Midscene.js

Let AI be your browser operator.

Midscene.js lets AI be your browser operator 🤖.Just describe what you want to do in natural language, and it will help you operate web pages, validate content, and extract data. Whether you want a quick experience or deep development, you can get started easily.

Showcases

The following recorded example video is based on the UI-TARS 7B SFT model, and the video has not been sped up at all~

📢 New open-source model choice - UI-TARS and Qwen2.5-VL

Besides the default model GPT-4o, we have added two new recommended open-source models to Midscene.js: UI-TARS and Qwen2.5-VL. (Yes, Open Source !) They are dedicated models for image recognition and UI automation, which are known for performing well in UI automation scenarios. Read more about it in Choose a model.

💡 Features

• Natural Language Interaction 👆: Just describe your goals and steps, and Midscene will plan and operate the user interface for you.
• Chrome Extension Experience 🖥️: Start experiencing immediately through the Chrome extension, no coding required.
• Puppeteer/Playwright Integration 🔧: Supports Puppeteer and Playwright integration, allowing you to combine AI capabilities with these powerful automation tools for easy automation.
• Support Open-Source Models 🤖: Supports private deployment of UI-TARS and Qwen2.5-VL, which outperforms closed-source models like GPT-4o and Claude in UI automation scenarios while better protecting data security.
• Support General Models 🌟: Supports general large models like GPT-4o and Claude, adapting to various scenario needs.
• Visual Reports for Debugging 🎞️: Through our test reports and Playground, you can easily understand, replay and debug the entire process.
• Support Caching 🔄: The first time you execute a task through AI, it will be cached, and subsequent executions of the same task will significantly improve execution efficiency.
• Completely Open Source 🔥: Experience a whole new automation development experience, enjoy!
• Understand UI, JSON Format Responses 🔍: You can specify data format requirements and receive responses in JSON format.
• Intuitive Assertions 🤔: Express your assertions in natural language, and AI will understand and process them.

✨ Model Choices

• You can use general-purpose LLMs like gpt-4o, it works well for most cases. And also, gemini-1.5-pro, qwen-vl-max-latest are supported.
• You can also use UI-TARS model, which is an open-source model dedicated for UI automation. You can deploy it on your own server, and it will dramatically improve the performance and data privacy.
• Read more about Choose a model

👀 Comparing to …

There are so many UI automation tools out there, and each one seems to be all-powerful. What’s special about Midscene.js?

• Debugging Experience: You will soon find that debugging and maintaining automation scripts is the real challenge point. No matter how magic the demo is, you still need to debug the process to make it stable over time. Midscene.js offers a visualized report file, a built-in playground, and a Chrome Extension to debug the entire process. This is what most developers really need. And we’re continuing to work on improving the debugging experience.

• Open Source, Free, Deploy as you want: Midscene.js is an open-source project. It’s decoupled from any cloud service and model provider, you can choose either public or private deployment. There is always a suitable plan for your business.

• Integrate with Javascript: You can always bet on Javascript 😎

📄 Resources

• Home Page: https://midscenejs.com
• Quick Experience By Chrome Extension, this is where you should get started
• Integration
  • Automate with Scripts in YAML, use this if you prefer to write YAML file instead of code
  • Bridge Mode by Chrome Extension, use this to control the desktop Chrome by scripts
  • Integrate with Puppeteer
  • Integrate with Playwright
• API Reference
• Choose a model
• Config Model and Provider

🤝 Community

• Discord
• Follow us on X
• Lark Group

Citation

If you use Midscene.js in your research or project, please cite:

@software{Midscene.js,
  author = {Zhou, Xiao and Yu, Tao},
  title = {Midscene.js: Let AI be your browser operator.},
  year = {2025},
  publisher = {GitHub},
  url = {https://github.com/web-infra-dev/midscene}
}

📝 License

Midscene.js is MIT licensed.