Skip to content

Conversation

@pirate
Copy link
Member

@pirate pirate commented Jan 13, 2026

Summary

  • Replace README header with standardized Stagehand branding
  • Update docs URL to /v3/sdk/python
  • Add 'What is Stagehand?' and 'Why Stagehand?' sections

Changes

This PR updates the README.md to match the standard Stagehand branding and includes:

  • Visual branding elements (logo with dark/light mode support)
  • License and Discord badges
  • Comprehensive "What is Stagehand?" and "Why Stagehand?" sections
  • Updated documentation links

🤖 Generated with Claude Code


Summary by cubic

Standardizes the README with Stagehand branding and adds a concise product overview. Updates docs links to point to the v3 Python SDK.

  • New Features
    • Branded header with dark/light logo and tagline
    • MIT license, Discord, and Trendshift badges
    • “What is Stagehand?” and “Why Stagehand?” sections highlighting code + natural language, caching, and self-healing
    • Updated docs links to /v3/sdk/python and added cross-language docs link
    • Removed outdated header and PyPI badge

Written for commit e16747b. Summary will update on new commits.

- Replace README header with standardized Stagehand branding
- Update docs URL to /v3/sdk/python
- Add 'What is Stagehand?' and 'Why Stagehand?' sections

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>
Copy link

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

1 issue found across 1 file

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="README.md">

<violation number="1" location="README.md:5">
P1: The `media/` directory referenced by these image paths does not exist in the repository. All logo and badge images will be broken. Ensure the media directory with the required assets (dark_logo.png, light_logo.png, dark_license.svg, light_license.svg, dark_discord.svg, light_discord.svg, director_icon.svg) is added to the repository.</violation>
</file>

Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.

<ul style="list-style: none; margin: 0; padding: 0;">
<a href="https://stagehand.dev">
<picture>
<source media="(prefers-color-scheme: dark)" srcset="media/dark_logo.png" />
Copy link

@cubic-dev-ai cubic-dev-ai bot Jan 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

P1: The media/ directory referenced by these image paths does not exist in the repository. All logo and badge images will be broken. Ensure the media directory with the required assets (dark_logo.png, light_logo.png, dark_license.svg, light_license.svg, dark_discord.svg, light_discord.svg, director_icon.svg) is added to the repository.

Prompt for AI agents
Check if this issue is valid — if so, understand the root cause and fix it. At README.md, line 5:

<comment>The `media/` directory referenced by these image paths does not exist in the repository. All logo and badge images will be broken. Ensure the media directory with the required assets (dark_logo.png, light_logo.png, dark_license.svg, light_license.svg, dark_discord.svg, light_discord.svg, director_icon.svg) is added to the repository.</comment>

<file context>
@@ -1,10 +1,67 @@
+  <ul style="list-style: none; margin: 0; padding: 0;">
+    <a href="https://stagehand.dev">
+      <picture>
+        <source media="(prefers-color-scheme: dark)" srcset="media/dark_logo.png" />
+        <img alt="Stagehand" src="media/light_logo.png" width="200" style="margin-right: 30px;" />
+      </picture>
</file context>
Fix with Cubic

@pirate pirate merged commit ed714db into stainless Jan 13, 2026
6 of 8 checks passed
miguelg719 added a commit that referenced this pull request Jan 13, 2026
* Initial commit

* initial commit

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* codegen metadata

* chore(internal): add missing files argument to base client

* codegen metadata

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

* release: 0.1.0 (#250)

* feat(api): manual updates

* feat(api): manual updates

* codegen metadata

* codegen metadata

* feat(api): manual updates

* codegen metadata

* feat(api): manual updates

* feat(api): manual updates

* codegen metadata

* feat(api): manual updates

* codegen metadata

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* codegen metadata

* feat(api): manual updates

* chore: speedup initial import

* refactor(internal): switch from rye to uv

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* feat(api): manual updates

* codegen metadata

* feat(api): manual updates

* feat(api): manual updates

* fix: use async_to_httpx_files in patch method

* chore(internal): add `--fix` argument to lint script

* feat(api): manual updates

* docs: add more examples

* feat: [STG-1053] [server] Use fastify-zod-openapi + zod v4 for openapi generation

* chore: update SDK settings

* chore: update SDK settings

* release: 0.1.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* release: 0.2.0 (#258)

* feat(api): manual updates

* codegen metadata

* docs: prominently feature MCP server setup in root SDK readmes

* feat: Added optional param to force empty object

* release: 0.2.0

* Added x-language and minimal agent example

* lint fix

* Added full example + updated readme

* Added local binary logic

* Added empty body logic for /end endpoint

* lint fix

* Added bundling logic for wheels

* lint fix

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: monadoid <[email protected]>

* release: 0.2.1 (#259)

* fix: specify pnpm version 9 in publish workflow

* release: 0.2.1

---------

Co-authored-by: monadoid <[email protected]>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* release: 0.2.2 (#260)

* fix: specify pnpm version 9 in publish workflow

* fix: correct binary names and update macOS runner in publish workflow

* release: 0.2.2

---------

Co-authored-by: monadoid <[email protected]>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* release: 0.2.3 (#261)

* fix: use macos-15-intel runner for darwin-x64 builds

* release: 0.2.3

---------

Co-authored-by: monadoid <[email protected]>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* release: 0.2.4 (#262)

* codegen metadata

* Added x_sdk_version headers + resolved api path

* docs: update README with SDK version headers

* release: 0.2.4

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: monadoid <[email protected]>

* Addressing (some) stainless notion doc comments (#264)

* Added session create helper

* Using existing types

* Showing only async python examples

* docs show using uv

* Added local example

* lint fix

* Made frameId optional (#266)

* Made frameId optional

* Added link to local_example in readme.

* Minimal working byob example

* Working bring-your-own-browser-driver example interleaving playwright with stagehand.

* Added logging example (#267)

* Add back in x-sent-at so that start_time and end_time work again (#268)

* Updated readme to mention installing chrome / providing CHROME_PATH (#269)

* release: 0.3.0 (#265)

* feat: Removed requiring x-language and x-sdk-version from openapi spec

* feat: Using provider/model syntax in modelName examples within openapi spec

* release: 0.3.0

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* Fix download-binary script to pull latest version of stagehand-server

* Using proper x-sent-at timestamp

* make AsyncSession and Session subclass SessionStartResponse for compat with autogen sdk docs (#271)

* remove x-language and x-sdk-version (#272)

* remove x-language and x-sdk-version

* linting

* browserbase headers not required when server=local and browser=local

* release: 0.3.1 (#270)

* codegen metadata

* release: 0.3.1

---------

Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>

* Renamed local_binary_path to _local_stagehand_binary_path, making it internal and clarifying the name

* MODEL_API_KEY is the public facing env, but either MODEL_API_KEY or OPENAI_API_KEY can be used - one is required to be set.

* Removed frame_id empty string passing

* allow passing chrome path as init param not only env var

* Standardize README with Stagehand branding (#275)

- Replace README header with standardized Stagehand branding
- Update docs URL to /v3/sdk/python
- Add 'What is Stagehand?' and 'Why Stagehand?' sections

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-authored-by: Claude Sonnet 4.5 <[email protected]>

* Fix media URLs to use absolute GitHub paths (#276)

* Standardize README with Stagehand branding

- Replace README header with standardized Stagehand branding
- Update docs URL to /v3/sdk/python
- Add 'What is Stagehand?' and 'Why Stagehand?' sections

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

* Fix media URLs to use absolute GitHub paths

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Sonnet 4.5 <[email protected]>

---------

Co-authored-by: Claude Sonnet 4.5 <[email protected]>

* fix install command

* Added a minimal playwright Page helper (#274)

* Update README.md (#278)

* release doctor main

---------

Co-authored-by: stainless-sdks[bot] <167585319+stainless-sdks[bot]@users.noreply.github.com>
Co-authored-by: stainless-app[bot] <142633134+stainless-app[bot]@users.noreply.github.com>
Co-authored-by: monadoid <[email protected]>
Co-authored-by: Sam F <[email protected]>
Co-authored-by: Nick Sweeting <[email protected]>
Co-authored-by: Claude Sonnet 4.5 <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants