feat(api): tweak branding and fix some config fields

Author: stainless-app[bot]

.stats.yml

@@ -1,4 +1,4 @@
 configured_endpoints: 7
 openapi_spec_url: https://storage.googleapis.com/stainless-sdk-openapi-specs/browserbase%2Fstagehand-0c12f985340be2a9287e8e01ff8733f7f2d02e019149d1ae95f1a8f8798c6690.yml
 openapi_spec_hash: efb79934e1dc63763dd4e8493b825273
-config_hash: cb2b1795c195a63201c8ef7a617934d1
+config_hash: 1548ab91b7e8621f7fa79e8cff0c3f93

LICENSE

@@ -186,7 +186,7 @@
       same "printed page" as the copyright notice for easier
       identification within third-party archives.
 
-   Copyright 2025 Stagehand
+   Copyright 2025 Browserbase
 
    Licensed under the Apache License, Version 2.0 (the "License");
    you may not use this file except in compliance with the License.

README.md

@@ -1,9 +1,9 @@
-# Stagehand Python API library
+# Browserbase Python API library
 
 <!-- prettier-ignore -->
 [![PyPI version](https://img.shields.io/pypi/v/stagehand.svg?label=pypi%20(stable))](https://pypi.org/project/stagehand/)
 
-The Stagehand Python library provides convenient access to the Stagehand REST API from any Python 3.9+
+The Browserbase Python library provides convenient access to the Browserbase REST API from any Python 3.9+
 application. The library includes type definitions for all request params and response fields,
 and offers both synchronous and asynchronous clients powered by [httpx](https://github.com/encode/httpx).
 
@@ -29,12 +29,12 @@ The full API of this library can be found in [api.md](api.md).
 
 ```python
 import os
-from stagehand import Stagehand
+from stagehand import Browserbase
 
-client = Stagehand(
+client = Browserbase(
     api_key=os.environ.get("STAGEHAND_API_KEY"),  # This is the default and can be omitted
-    # defaults to "production".
-    environment="environment_1",
+    # or 'production' | 'local'; defaults to "production".
+    environment="dev",
 )
 
 response = client.sessions.start(
@@ -50,17 +50,17 @@ so that your API Key is not stored in source control.
 
 ## Async usage
 
-Simply import `AsyncStagehand` instead of `Stagehand` and use `await` with each API call:
+Simply import `AsyncBrowserbase` instead of `Browserbase` and use `await` with each API call:
 
 ```python
 import os
 import asyncio
-from stagehand import AsyncStagehand
+from stagehand import AsyncBrowserbase
 
-client = AsyncStagehand(
+client = AsyncBrowserbase(
     api_key=os.environ.get("STAGEHAND_API_KEY"),  # This is the default and can be omitted
-    # defaults to "production".
-    environment="environment_1",
+    # or 'production' | 'local'; defaults to "production".
+    environment="dev",
 )
 
 
@@ -93,11 +93,11 @@ Then you can enable it by instantiating the client with `http_client=DefaultAioH
 import os
 import asyncio
 from stagehand import DefaultAioHttpClient
-from stagehand import AsyncStagehand
+from stagehand import AsyncBrowserbase
 
 
 async def main() -> None:
-    async with AsyncStagehand(
+    async with AsyncBrowserbase(
         api_key=os.environ.get("STAGEHAND_API_KEY"),  # This is the default and can be omitted
         http_client=DefaultAioHttpClient(),
     ) as client:
@@ -124,9 +124,9 @@ Typed requests and responses provide autocomplete and documentation within your
 Nested parameters are dictionaries, typed using `TypedDict`, for example:
 
 ```python
-from stagehand import Stagehand
+from stagehand import Browserbase
 
-client = Stagehand()
+client = Browserbase()
 
 response = client.sessions.start(
     env="LOCAL",
@@ -146,9 +146,9 @@ All errors inherit from `stagehand.APIError`.
 
 ```python
 import stagehand
-from stagehand import Stagehand
+from stagehand import Browserbase
 
-client = Stagehand()
+client = Browserbase()
 
 try:
     client.sessions.start(
@@ -187,10 +187,10 @@ Connection errors (for example, due to a network connectivity problem), 408 Requ
 You can use the `max_retries` option to configure or disable retry settings:
 
 ```python
-from stagehand import Stagehand
+from stagehand import Browserbase
 
 # Configure the default for all requests:
-client = Stagehand(
+client = Browserbase(
     # default is 2
     max_retries=0,
 )
@@ -207,16 +207,16 @@ By default requests time out after 1 minute. You can configure this with a `time
 which accepts a float or an [`httpx.Timeout`](https://www.python-httpx.org/advanced/timeouts/#fine-tuning-the-configuration) object:
 
 ```python
-from stagehand import Stagehand
+from stagehand import Browserbase
 
 # Configure the default for all requests:
-client = Stagehand(
+client = Browserbase(
     # 20 seconds (default is 1 minute)
     timeout=20.0,
 )
 
 # More granular control:
-client = Stagehand(
+client = Browserbase(
     timeout=httpx.Timeout(60.0, read=5.0, write=10.0, connect=2.0),
 )
 
@@ -236,10 +236,10 @@ Note that requests that time out are [retried twice by default](#retries).
 
 We use the standard library [`logging`](https://docs.python.org/3/library/logging.html) module.
 
-You can enable logging by setting the environment variable `STAGEHAND_LOG` to `info`.
+You can enable logging by setting the environment variable `BROWSERBASE_LOG` to `info`.
 
 ```shell
-$ export STAGEHAND_LOG=info
+$ export BROWSERBASE_LOG=info
 ```
 
 Or to `debug` for more verbose logging.
@@ -261,9 +261,9 @@ if response.my_field is None:
 The "raw" Response object can be accessed by prefixing `.with_raw_response.` to any HTTP method call, e.g.,
 
 ```py
-from stagehand import Stagehand
+from stagehand import Browserbase
 
-client = Stagehand()
+client = Browserbase()
 response = client.sessions.with_raw_response.start(
     env="LOCAL",
 )
@@ -339,10 +339,10 @@ You can directly override the [httpx client](https://www.python-httpx.org/api/#c
 
 ```python
 import httpx
-from stagehand import Stagehand, DefaultHttpxClient
+from stagehand import Browserbase, DefaultHttpxClient
 
-client = Stagehand(
-    # Or use the `STAGEHAND_BASE_URL` env var
+client = Browserbase(
+    # Or use the `BROWSERBASE_BASE_URL` env var
     base_url="http://my.test.server.example.com:8083",
     http_client=DefaultHttpxClient(
         proxy="http://my.test.proxy.example.com",
@@ -362,9 +362,9 @@ client.with_options(http_client=DefaultHttpxClient(...))
 By default the library closes underlying HTTP connections whenever the client is [garbage collected](https://docs.python.org/3/reference/datamodel.html#object.__del__). You can manually close the client using the `.close()` method if desired, or with a context manager that closes when exiting.
 
 ```py
-from stagehand import Stagehand
+from stagehand import Browserbase
 
-with Stagehand() as client:
+with Browserbase() as client:
   # make requests here
   ...
 

SECURITY.md

@@ -16,7 +16,7 @@ before making any information public.
 ## Reporting Non-SDK Related Security Issues
 
 If you encounter security issues that are not directly related to SDKs but pertain to the services
-or products provided by Stagehand, please follow the respective company's security reporting guidelines.
+or products provided by Browserbase, please follow the respective company's security reporting guidelines.
 
 ---
 

pyproject.toml

@@ -1,11 +1,11 @@
 [project]
 name = "stagehand"
 version = "0.0.1"
-description = "The official Python library for the stagehand API"
+description = "The official Python library for the browserbase API"
 dynamic = ["readme"]
 license = "Apache-2.0"
 authors = [
-{ name = "Stagehand", email = "" },
+{ name = "Browserbase", email = "" },
 ]
 
 dependencies = [

src/stagehand/__init__.py

@@ -10,12 +10,12 @@
     Client,
     Stream,
     Timeout,
-    Stagehand,
     Transport,
     AsyncClient,
     AsyncStream,
-    AsyncStagehand,
+    Browserbase,
     RequestOptions,
+    AsyncBrowserbase,
 )
 from ._models import BaseModel
 from ._version import __title__, __version__
@@ -27,9 +27,9 @@
     NotFoundError,
     APIStatusError,
     RateLimitError,
-    StagehandError,
     APITimeoutError,
     BadRequestError,
+    BrowserbaseError,
     APIConnectionError,
     AuthenticationError,
     InternalServerError,
@@ -52,7 +52,7 @@
     "not_given",
     "Omit",
     "omit",
-    "StagehandError",
+    "BrowserbaseError",
     "APIError",
     "APIStatusError",
     "APITimeoutError",
@@ -72,8 +72,8 @@
     "AsyncClient",
     "Stream",
     "AsyncStream",
-    "Stagehand",
-    "AsyncStagehand",
+    "Browserbase",
+    "AsyncBrowserbase",
     "ENVIRONMENTS",
     "file_from_path",
     "BaseModel",