Get started: Web · Playground · ChatGPT subscription
These are the setup steps for Midscene on Web with Playground and a ChatGPT subscription. To choose another combination, change the answers below or see all setup paths.
Step 1
Install the Chrome extension
-
Install Midscene from the Chrome Web Store:
-
Open Midscene from the Chrome extensions list. The Midscene sidebar appears on the right side of the browser.
If you cannot access the Chrome Web Store, see Can I install the Chrome extension manually?
Step 2
Sign in with your ChatGPT subscription
- In the Midscene sidebar, click the settings icon to open the model configuration dialog, then click Use your ChatGPT plan and follow the on-screen instructions to sign in and authorize plan usage.
- Paste the following configuration into the same dialog:
- Click Verify to test the connection. For failed checks, see Model advanced configuration and debugging.
Available models depend on your ChatGPT account. For credentials and usage, see Use a ChatGPT subscription.
Step 3
Run an action and verify the result
Open TodoMVC in the current tab and keep the page visible.
- Select
aiActin the side panel, enter the following instruction, and run it:
- Once the completed todo item appears on the page, switch to
aiAssert, enter the following assertion, and run it:
-
Confirm that the assertion passes and inspect the step-by-step screenshots in the results panel.
-
(Optional) Switch to
aiQuery, enter the following query, and run it:
The result contains each todo item's name and completion status. aiQuery extracts data from the current UI without changing the page.
If execution fails, inspect the failed step and error message. For model request errors, see Verify model connectivity and Common configuration errors. For extension errors when accessing a page or Ollama, see the Web FAQ.
Step 4
Next steps
- Explore more examples: Showcases includes demo videos and full execution reports across platforms.
- Write repeatable cases: Create a Midscene Test project with the same platform and model. Cases are YAML files that you can run locally or in CI.
- Add to Playwright Test: Call Midscene from your Playwright tests with the same model.
- Control this browser from scripts: Chrome Bridge lets Node.js scripts control your desktop Chrome and reuse its login sessions and cookies.
- Learn how Midscene works: The Basics explains the vision-based approach and when to use
aiAct, instant actions, and insight APIs.
Want to try another platform or way to use Midscene? Back to top to change your selections.


