From b75918068c4befd679790e0a23dadd31c59ba2b7 Mon Sep 17 00:00:00 2001 From: mathisdittrich Date: Thu, 10 Sep 2026 09:59:21 -0700 Subject: [PATCH] docs: install Browser Use from the Vercel Marketplace via the deploy button The Deploy with Vercel button now carries a stores parameter for the browseruse/agent Marketplace product, so the deploy flow installs the integration and sets BROWSER_USE_API_KEY on the project instead of prompting for the key by hand. Vercel's approval checklist requires a Marketplace template as a deploy option in the product flow. Co-Authored-By: Claude Fable 5.1 --- README.md | 8 +++++--- docs/ENVIRONMENT.md | 4 +++- 2 files changed, 8 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index 8602727..ce1c02c 100644 --- a/README.md +++ b/README.md @@ -8,7 +8,7 @@ **Template.** Fork it, customize it, and deploy your own web-browsing agent. -[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template&env=BROWSER_USE_API_KEY,AI_GATEWAY_API_KEY&envDescription=BROWSER_USE_API_KEY%20from%20browser-use.com%20%7C%20a%20model%20credential%20for%20the%20AI%20Gateway&envLink=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template%2Fblob%2Fmain%2Fdocs%2FENVIRONMENT.md&project-name=browser-agent&repository-name=browser-agent) +[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template&env=AI_GATEWAY_API_KEY&envDescription=A%20model%20credential%20for%20the%20Vercel%20AI%20Gateway%20(BROWSER_USE_API_KEY%20is%20set%20by%20the%20Browser%20Use%20Marketplace%20integration)&envLink=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template%2Fblob%2Fmain%2Fdocs%2FENVIRONMENT.md&project-name=browser-agent&repository-name=browser-agent&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22browseruse%22%2C%22productSlug%22%3A%22agent%22%7D%5D) --- @@ -58,9 +58,11 @@ It's a single Next.js service: `withEve()` in [`next.config.ts`](next.config.ts) ### Deploy to Vercel -[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template&env=BROWSER_USE_API_KEY,AI_GATEWAY_API_KEY&envDescription=BROWSER_USE_API_KEY%20from%20browser-use.com%20%7C%20a%20model%20credential%20for%20the%20AI%20Gateway&envLink=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template%2Fblob%2Fmain%2Fdocs%2FENVIRONMENT.md&project-name=browser-agent&repository-name=browser-agent) +[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template&env=AI_GATEWAY_API_KEY&envDescription=A%20model%20credential%20for%20the%20Vercel%20AI%20Gateway%20(BROWSER_USE_API_KEY%20is%20set%20by%20the%20Browser%20Use%20Marketplace%20integration)&envLink=https%3A%2F%2Fgithub.com%2Fbrowser-use%2Fbrowser-agent-template%2Fblob%2Fmain%2Fdocs%2FENVIRONMENT.md&project-name=browser-agent&repository-name=browser-agent&stores=%5B%7B%22type%22%3A%22integration%22%2C%22integrationSlug%22%3A%22browseruse%22%2C%22productSlug%22%3A%22agent%22%7D%5D) -You'll be asked for a `BROWSER_USE_API_KEY` (from [browser-use.com](https://browser-use.com)) and a model credential (link the Vercel project for the AI Gateway, or set `AI_GATEWAY_API_KEY`). +The deploy flow installs the [Browser Use integration](https://vercel.com/marketplace/browseruse) from the Vercel Marketplace, which creates your Browser Use account, bills through Vercel, and sets `BROWSER_USE_API_KEY` on the project. You'll also be asked for a model credential (link the Vercel project for the AI Gateway, or set `AI_GATEWAY_API_KEY`). + +Already have a Browser Use key? Import the repo into Vercel and set `BROWSER_USE_API_KEY` yourself instead (see [ENVIRONMENT.md](./docs/ENVIRONMENT.md)). ### Self-hosting diff --git a/docs/ENVIRONMENT.md b/docs/ENVIRONMENT.md index 3b72070..80a0294 100644 --- a/docs/ENVIRONMENT.md +++ b/docs/ENVIRONMENT.md @@ -9,7 +9,9 @@ project's **Settings → Environment Variables**. Your [Browser Use](https://browser-use.com) cloud key (`bu_...`). Used server-side to provision and tear down cloud browsers. Never exposed to the model or the sandbox. -Get one at [browser-use.com](https://browser-use.com). +The **Deploy with Vercel** button sets it for you by installing the +[Browser Use Marketplace integration](https://vercel.com/marketplace/browseruse); +otherwise get one at [browser-use.com](https://browser-use.com). ### A model credential