> For AI agents: the complete documentation index is available at /llms.txt, the full documentation bundle is available at /llms-full.txt.

# Get started: Web · Playground · ChatGPT subscription {#get-started}

These are the setup steps for Midscene on **Web** with **Playground** and a **ChatGPT subscription**. To choose another combination, see [all setup paths](/get-started.md#all-setup-paths).

## Install the Chrome extension
1. Install Midscene from the Chrome Web Store:

   [Install the Midscene extension from the Chrome Web Store](https://chromewebstore.google.com/detail/midscene/gbldofcpkknbggpkmbdaefngejllnief)

2. 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?](/platforms/web.md#chrome-extension-faq)

## Sign in with your ChatGPT subscription
1. 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.
2. Paste the following configuration into the same dialog:

```bash
MIDSCENE_MODEL_AUTH_MODE="siwc"
MIDSCENE_MODEL_NAME="gpt-6-sol"
MIDSCENE_MODEL_FAMILY="gpt-6"
```

3. Click **Verify** to test the connection. For failed checks, see [Model advanced configuration and debugging](/model-config.md#verify-model-connectivity).
Available models depend on your ChatGPT account. For credentials and usage, see [Use a ChatGPT subscription](/chatgpt-subscription.md#usage-and-credentials).

## Run an action and verify the result
Open [TodoMVC](https://todomvc.com/examples/react/dist/#/) in the current tab and keep the page visible.
1. Select `aiAct` in the side panel, enter the following instruction, and run it:

```text
Add a todo named "Try Midscene", then mark it as completed.
```

2. Once the completed todo item appears on the page, switch to `aiAssert`, enter the following assertion, and run it:

```text
The list contains a todo named "Try Midscene", and it is marked as completed.
```

3. Confirm that the assertion passes and inspect the step-by-step screenshots in the results panel.

4. (Optional) Switch to `aiQuery`, enter the following query, and run it:

```text
Return the visible todo items as {name: string, completed: boolean}[].
```

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](/model-config.md#verify-model-connectivity) and [Common configuration errors](/model-config.md#common-configuration-errors). For extension errors when accessing a page or Ollama, see the [Web FAQ](/platforms/web.md#chrome-extension-faq).

## Next steps
- **Explore more examples**: [Showcases](/showcases.md) includes demo videos and full execution reports across platforms.

- **Write repeatable cases**: [Create a Midscene Test project](/get-started/web-test-chatgpt.md) 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](/get-started/web-sdk-chatgpt.md) with the same model.
- **Control this browser from scripts**: [Chrome Bridge](/bridge-mode.md) lets Node.js scripts control your desktop Chrome and reuse its login sessions and cookies.

- **Learn how Midscene works**: [The Basics](/basics.md) explains the vision-based approach and when to use `aiAct`, instant actions, and insight APIs.
