Migrate templates to Model Gateway — remove separate model API keys, bump SDKs (#76)

* Migrate templates to Browserbase Model Gateway

* Fix Model Gateway naming and remove CUA notes from READMEs

* using correct package version

* updated stagehand package version to use latest

* Remove BROWSERBASE_PROJECT_ID from Stagehand templates

* bumped bb sdk versons

Author: jay-sahnan

README.md

@@ -20,6 +20,12 @@ A comprehensive collection of ready-to-use automation templates demonstrating th
 
 > **💡 Pro Tip**: Each template's README contains detailed installation steps, environment variable requirements, and troubleshooting guides specific to that template.
 
+## Model Gateway
+
+Templates use the Model Gateway to route LLM requests — you only need your `BROWSERBASE_API_KEY`. No separate OpenAI, Anthropic, or Google API keys required. Supported models include OpenAI, Anthropic, and Google (Gemini).
+
+> **Note**: CUA (Computer Use Agent) models are not yet supported through the Model Gateway. Templates using CUA models still require a separate model provider API key.
+
 ## 📚 Resources
 
 ### Documentation

go/hackernews/README.md

@@ -26,7 +26,6 @@
 2. Set required environment variables:
    ```bash
    export BROWSERBASE_API_KEY="your-api-key"
-   export BROWSERBASE_PROJECT_ID="your-project-id"
    export MODEL_API_KEY="your-model-api-key"
    ```
 3. Run the example:
@@ -48,10 +47,10 @@
 ## COMMON PITFALLS
 
 - Missing Go installation: Ensure Go 1.22+ is installed (`go version`)
-- Missing environment variables: Verify BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, and MODEL_API_KEY are set
+- Missing environment variables: Verify BROWSERBASE_API_KEY and MODEL_API_KEY are set
 - Module not found: Run `go mod download` if dependencies aren't resolved
 - Network issues: Check internet connection and website accessibility
-- Session errors: Verify API keys are valid and project ID exists in Browserbase dashboard
+- Session errors: Verify API keys are valid in Browserbase dashboard
 - Find more information on your Browserbase dashboard -> https://www.browserbase.com/sign-in
 
 ## USE CASES

go/hackernews/main.go

@@ -15,7 +15,6 @@ func main() {
 	// Create client using environment variables
 	client := stagehand.NewClient(
 		option.WithBrowserbaseAPIKey(os.Getenv("BROWSERBASE_API_KEY")),
-		option.WithBrowserbaseProjectID(os.Getenv("BROWSERBASE_PROJECT_ID")),
 		option.WithModelAPIKey(os.Getenv("MODEL_API_KEY")),
 	)
 

python/amazon-global-price-comparison/.env.example

@@ -1,7 +1,2 @@
 # Browserbase credentials - get these from https://www.browserbase.com/settings
 BROWSERBASE_API_KEY=your_browserbase_api_key
-BROWSERBASE_PROJECT_ID=your_browserbase_project_id
-
-# Model API key for Stagehand AI capabilities
-# Use Google API key for Gemini models, or OpenAI API key for GPT models
-MODEL_API_KEY=your_model_api_key

python/amazon-global-price-comparison/README.md

@@ -25,9 +25,7 @@
 1. cd python/amazon-global-price-comparison
 2. cp .env.example .env
 3. Add required API keys to .env:
-   - `BROWSERBASE_PROJECT_ID`
    - `BROWSERBASE_API_KEY`
-   - `MODEL_API_KEY` (Google API key for Gemini, or OpenAI API key)
 4. Run the script:
    ```bash
    uv run python main.py
@@ -45,7 +43,7 @@
 
 - **Browserbase Developer plan or higher is required to use proxies**
 - "ModuleNotFoundError": ensure you're running with `uv run python main.py` (uv automatically installs dependencies from pyproject.toml)
-- Missing credentials: verify .env contains `BROWSERBASE_PROJECT_ID`, `BROWSERBASE_API_KEY`, and `MODEL_API_KEY`
+- Missing credentials: verify .env contains `BROWSERBASE_API_KEY`
 - Geolocation fields are case-insensitive (city, country can be any case)
 - Amazon may show different products in different regions - comparison works best for globally available products
 - ERR_TUNNEL_CONNECTION_FAILED: indicates either a temporary proxy hiccup or a site unsupported by built-in proxies

python/amazon-global-price-comparison/main.py

@@ -8,11 +8,10 @@
 from browserbase import Browserbase
 from dotenv import load_dotenv
 from pydantic import BaseModel, Field
-
 from stagehand import AsyncStagehand
 
 # Load environment variables from .env file
-# Required: BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
+# Required: BROWSERBASE_API_KEY
 load_dotenv()
 
 
@@ -34,7 +33,9 @@ class Product(BaseModel):
     )
     product_url: str = Field(
         default="N/A",
-        description="The full href URL link to the product detail page (starting with https:// or /dp/)",
+        description=(
+            "The full href URL link to the product detail page (starting with https:// or /dp/)"
+        ),
     )
 
 
@@ -58,7 +59,8 @@ class CountryConfig:
 
 
 # Supported countries for price comparison
-# Add or remove countries as needed - see https://docs.browserbase.com/features/proxies for available geolocations
+# Add or remove countries as needed - see
+# https://docs.browserbase.com/features/proxies for available geolocations
 COUNTRIES: list[CountryConfig] = [
     CountryConfig(name="United States", code="US", city=None, currency="USD"),
     CountryConfig(name="United Kingdom", code="GB", city="LONDON", currency="GBP"),
@@ -127,8 +129,6 @@ async def get_products_for_country(
     # Initialize AsyncStagehand client (v3 API)
     client = AsyncStagehand(
         browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"),
-        browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"),
-        model_api_key=os.environ.get("MODEL_API_KEY"),
     )
 
     try:
@@ -170,7 +170,11 @@ async def get_products_for_country(
                             },
                             "price": {
                                 "type": "string",
-                                "description": "The product price including currency symbol (e.g., '$29.99'). If no price is visible, return 'N/A'",
+                                "description": (
+                                    "The product price including currency"
+                                    " symbol (e.g., '$29.99'). If no"
+                                    " price is visible, return 'N/A'"
+                                ),
                             },
                             "rating": {
                                 "type": "string",
@@ -193,14 +197,19 @@ async def get_products_for_country(
         }
 
         extract_response = await stagehand_session.extract(
-            instruction=f"""Extract the first {results_count} product search results from this Amazon page. For each product, extract:
-            1. name: the full product title
-            2. price: the displayed price WITH currency symbol (like $599.99 or 599,99 EUR). If no price shown, use "N/A"
-            3. rating: the star rating text (like "4.5 out of 5 stars")
-            4. reviews_count: the number of reviews (like "2,508")
-            5. product_url: the href link to the product page (starts with /dp/ or https://)
-
-            Only extract actual product listings, skip sponsored ads or recommendations.""",
+            instruction=(
+                f"Extract the first {results_count} product search results"
+                " from this Amazon page. For each product, extract:"
+                " 1. name: the full product title"
+                " 2. price: the displayed price WITH currency symbol"
+                ' (like $599.99 or 599,99 EUR). If no price shown, use "N/A"'
+                ' 3. rating: the star rating text (like "4.5 out of 5 stars")'
+                ' 4. reviews_count: the number of reviews (like "2,508")'
+                " 5. product_url: the href link to the product page"
+                " (starts with /dp/ or https://)"
+                " Only extract actual product listings, skip sponsored"
+                " ads or recommendations."
+            ),
             schema=products_schema,
         )
 
@@ -368,9 +377,7 @@ async def main():
     except Exception as err:
         print(f"Application error: {err}")
         print("\nCommon issues:")
-        print(
-            "  - Check .env file has BROWSERBASE_PROJECT_ID, BROWSERBASE_API_KEY, and MODEL_API_KEY"
-        )
+        print("  - Check .env file has BROWSERBASE_API_KEY")
         print(
             "  - Verify geolocation proxy locations are valid "
             "(see https://docs.browserbase.com/features/proxies)"

python/amazon-global-price-comparison/pyproject.toml

@@ -5,10 +5,10 @@ description = "Compare Amazon product prices across multiple countries using geo
 readme = "README.md"
 requires-python = ">=3.9"
 dependencies = [
-    "browserbase>=1.5.0",
+    "browserbase>=1.7.0",
     "python-dotenv",
     "pydantic>=2.0.0",
-    "stagehand",
+    "stagehand>=3.19.0",
 ]
 
 [project.optional-dependencies]

python/amazon-product-scraping/.env.example

@@ -1,10 +1,3 @@
 # Browserbase credentials (required)
 # Get these from https://www.browserbase.com/settings
-BROWSERBASE_PROJECT_ID=your-browserbase-project-id
 BROWSERBASE_API_KEY=your-browserbase-api-key
-
-# Model API key (required - use one of these)
-# For Google Gemini models
-MODEL_API_KEY=your-google-api-key
-# Or alternatively:
-# GOOGLE_API_KEY=your-google-api-key

python/amazon-product-scraping/README.md

@@ -19,7 +19,7 @@
 
 1. cd python/amazon-product-scraping
 2. cp .env.example .env (or create .env with required keys)
-3. Add `BROWSERBASE_PROJECT_ID`, `BROWSERBASE_API_KEY`, and `MODEL_API_KEY` (or `GOOGLE_API_KEY`) to .env
+3. Add `BROWSERBASE_API_KEY` to .env
 4. Optionally edit `SEARCH_QUERY` in main.py
 5. Run the script:
    ```bash
@@ -38,8 +38,7 @@
 ## COMMON PITFALLS
 
 - **Import errors**: Ensure you're running with `uv run python main.py` so dependencies are installed
-- **Missing credentials**: Verify .env contains `BROWSERBASE_PROJECT_ID`, `BROWSERBASE_API_KEY`, and `MODEL_API_KEY` (or `GOOGLE_API_KEY`)
-- **Google API access**: Ensure you have access to the gemini-2.5-flash model
+- **Missing credentials**: Verify .env contains `BROWSERBASE_API_KEY`
 - **Amazon layout changes**: Extraction may need prompt/schema updates if Amazon changes their search results UI
 - Find more information on your Browserbase dashboard → https://www.browserbase.com/sign-in
 

python/amazon-product-scraping/main.py

@@ -7,7 +7,6 @@
 
 from dotenv import load_dotenv
 from pydantic import BaseModel, Field
-
 from stagehand import AsyncStagehand
 
 
@@ -45,7 +44,7 @@ def resolve_refs(obj):
 
 
 # Load environment variables from .env file
-# Required: BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY (or GOOGLE_API_KEY)
+# Required: BROWSERBASE_API_KEY
 load_dotenv()
 
 # ============= CONFIGURATION =============
@@ -67,11 +66,9 @@ async def main():
     print("Starting Amazon Product Scraping...")
 
     # Initialize AsyncStagehand client (v3 BYOB architecture)
-    # Uses environment variables: BROWSERBASE_API_KEY, BROWSERBASE_PROJECT_ID, MODEL_API_KEY
+    # Uses environment variable: BROWSERBASE_API_KEY
     client = AsyncStagehand(
         browserbase_api_key=os.environ.get("BROWSERBASE_API_KEY"),
-        browserbase_project_id=os.environ.get("BROWSERBASE_PROJECT_ID"),
-        model_api_key=os.environ.get("MODEL_API_KEY") or os.environ.get("GOOGLE_API_KEY"),
     )
 
     # Start a Stagehand session with the specified model
@@ -131,8 +128,7 @@ async def main():
     except Exception as err:
         print(f"Error in Amazon product scraping: {err}")
         print("Common issues:")
-        print("  - Check .env file has BROWSERBASE_PROJECT_ID and BROWSERBASE_API_KEY")
-        print("  - Verify MODEL_API_KEY or GOOGLE_API_KEY is set for the model")
+        print("  - Check .env file has BROWSERBASE_API_KEY")
         print("  - Verify network connectivity")
         print("Docs: https://docs.stagehand.dev")
         exit(1)