71 Commits

Author SHA1 Message Date
Shrey Pandya
808f75f45e
Replace Slack references with Discord (#1492)
Updated all active documentation and code to point to Discord community instead of Slack. All community links now use https://stagehand.dev/discord for better SEO.

**Changes:**
- Replaced Slack badges with Discord in README files
- Updated community links in documentation pages and error messages
- Removed Slack footer link from docs config
- Excluded historical changelogs and changesets

๐Ÿค– Generated with [Claude Code](https://claude.com/claude-code)

<!-- This is an auto-generated description by cubic. -->
---
## Summary by cubic
Switched all community references from Slack to Discord, updating badges, links, docs, and messages to point to https://stagehand.dev/discord for better SEO.

- **Refactors**
  - Replaced Slack badges with Discord (added dark/light Discord SVGs, removed Slack SVGs).
  - Updated README files, docs pages, and cards to use https://stagehand.dev/discord.
  - Updated example and SDK error messages to mention Discord.
  - Removed Slack footer link; docs anchors now point to https://stagehand.dev/discord.
  - Excluded historical changelogs and changesets.
  - Updated license badges to 32px height to match Discord badges.

<sup>Written for commit 75e632a74b77bbdf0c0e4509c3719fbccd69f881. Summary will update on new commits.</sup>

<!-- End of auto-generated description by cubic. -->
2026-01-05 15:31:54 -05:00
Kyle Jeong
525ef0c124
[docs] update slack link + add deepwiki badge to repo readme (#1228)
# why

deepwiki is a great resource to help potential new contributors/users to
understand the repo quickly and deeply. adding the badge helps route
people there as well as get our repo auto refreshed for when we update.

# what changed

added badge to readme + also updated outdated slack invite link

# test plan
n/a

---------

Co-authored-by: Sean McGuire <seanmcguire1@outlook.com>
2025-11-03 17:50:30 -08:00
Miguel
9bf09d0411
Fix reamdme's media link and add instructions for branch installation (#1227)
# why

# what changed

# test plan
2025-11-03 14:36:48 -08:00
Miguel
55da8c6e95
Fix broken link to quickstart in the README (#1207)
# why
Link points to the old docs route

# what changed
Fixed link to the
[Quickstart](https://docs.stagehand.dev/v3/first-steps/quickstart)
section of the docs on the readme
Shoutout to @JerryWu1234 for the contrib

# test plan

---------

Co-authored-by: Jerry_wu <409187100@qq.com>
2025-10-30 11:25:37 -07:00
Miguel
ee7688156c
changelog v3 and core package readme (#1205)
# why
Changelog for v3 missing, package README for core missing

# what changed


# test plan
2025-10-30 10:33:34 -07:00
Sean McGuire
5f4a47efc6
update readme (#1195)
# why

# what changed

# test plan
2025-10-29 09:47:30 -07:00
Miguel
5834b5b3cd
update readme (#1192)
# why

# what changed

# test plan
2025-10-29 09:39:10 -07:00
Filip Michalsky
09b5e1e9c2
work on adding voyager to evals (#959)
โบ ## Why
Add WebVoyager and GAIA evaluation suites to benchmark Stagehand's web
navigation and
   reasoning capabilities against industry-standard datasets.

  ## What Changed
- Added WebVoyager eval suite with 643 test cases for web navigation
tasks
- Added GAIA eval suite with 90 test cases for general AI assistant
tasks
  - Refactored eval infrastructure to support sampling and filtering
- Created reusable utilities for JSONL parsing and test case generation
  - Added configuration for new eval suites in `evals.config.json`

  ### Environment Variables
  - `EVAL_WEBVOYAGER_SAMPLE`: Random sample size from WebVoyager dataset
  - `EVAL_WEBVOYAGER_LIMIT`: Max cases to run (default: 25)
  - `EVAL_GAIA_SAMPLE`: Random sample size from GAIA dataset
  - `EVAL_GAIA_LIMIT`: Max cases to run (default: 25)
  - `EVAL_GAIA_LEVEL`: Filter GAIA by difficulty level (1, 2, or 3)

  ### Sampling Strategy
The sampling implementation uses Fisher-Yates shuffle for unbiased
random selection
when `SAMPLE` is specified, otherwise takes the first `LIMIT` cases.
This allows for
  both deterministic (first N) and randomized (sample N) test runs.

  ## Test Plan
  ```bash
  # Test WebVoyager with OpenAI
  EVAL_SUITE=webvoyager EVAL_WEBVOYAGER_SAMPLE=1
  EVAL_MODEL=openai/gpt-4o-computer-use-preview pnpm run evals

  # Test WebVoyager with Claude
  EVAL_SUITE=webvoyager EVAL_WEBVOYAGER_SAMPLE=1
  EVAL_MODEL=anthropic/claude-3-5-sonnet-20241022 pnpm run evals

  # Test GAIA with OpenAI
EVAL_SUITE=gaia EVAL_GAIA_SAMPLE=1
EVAL_MODEL=openai/gpt-4o-computer-use-preview pnpm
   run evals

  # Test GAIA with Claude
EVAL_SUITE=gaia EVAL_GAIA_SAMPLE=1
EVAL_MODEL=anthropic/claude-3-5-sonnet-20241022
  pnpm run evals

  # Verify existing evals still work
  pnpm run evals
  ```

---------

Co-authored-by: Claude <noreply@anthropic.com>
Co-authored-by: Miguel <36487034+miguelg719@users.noreply.github.com>
2025-08-27 16:40:53 -04:00
Miguel
a5a0107a22
add feature parity workflow (#853)
# why
To keep up with changes on client SDKs

# what changed
Added a workflow 'Feature Parity' that, given an added (specific) label
to a PR, will open an issue on the sibling repo describing the PR for
future implementation

# test plan

---------

Co-authored-by: Roaring <216452114+the-roaring@users.noreply.github.com>
2025-06-30 15:09:08 -07:00
Sean McGuire
2d8485f9dc
[chore] update slack invite link (#852) 2025-06-29 22:54:42 +00:00
Miguel
a175a519b8
update logo (#810) 2025-06-17 08:19:34 -07:00
Miguel
4de92a8af4
Fix readme logo link (#783)
* Fix readme logo link

* resize

* bold catchphrase

* remove punctuation

* update catchphrase

* bring logo and catchphrase closer
2025-05-29 15:56:18 -07:00
Henry
ac07a053d6
Update README.md (#756) 2025-05-13 16:18:11 -07:00
Anirudh Kamath
7f194accc2
Clean up examples and pnpm scripts (#727)
* tsx

* change examples

* clean up examples

* fix ci

* Update examples/form_filling_sensible.ts

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>

* greptile

* fix external clients + add stagehand to evals

* fix ci

---------

Co-authored-by: greptile-apps[bot] <165735046+greptile-apps[bot]@users.noreply.github.com>
2025-05-03 13:26:48 -07:00
Anirudh Kamath
3ad822daa9
Go back to pnpm (#715)
* Switch back to pnpm

* cleanup npm -> pnpm

* fix workflows

* readme
2025-05-02 09:21:21 -07:00
Miguel
edd6d3feb4
Fix schema input (response_model) for Google AI client (#687)
* Fix schema input (response_model) for Google AI client

* acknowledgement
2025-04-18 16:23:20 -07:00
Anirudh Kamath
dc8b6b3bd6
final touches for v2 (#622)
* v2 readme

* minor

* line break

* getting started

* gif on top

* rm hr

* v2 readme

* minor

* line break

* getting started

* gif on top

* rm hr

* gif + cleanup

* revert example

* rm zod

* gif first

* gif first

* copy

* copy

* copy

* height

* pls

* prod ready

* features

* headings

* copy

* unpredictable in prod

* grammar

* spacing

* final?

* nl vs code

* cua

* cua

* change slack url

* new gif

* v2 readme

* minor

* line break

* getting started

* gif on top

* rm hr

* revert example

* rm zod

* gif first

* gif first

* copy

* copy

* copy

* height

* pls

* prod ready

* features

* headings

* copy

* unpredictable in prod

* grammar

* spacing

* final?

* nl vs code

* cua

* cua

* change slack url

* new gif

* config file

* cursorrules + config

* changelog
2025-03-31 02:10:47 -07:00
Anirudh Kamath
853e131a39
Add bun warning and remove roadmap doc (#475) 2025-02-08 13:44:06 -08:00
Paul Klein
8a89d7d0f6
Update slack link (#474) 2025-02-08 13:23:13 -08:00
Anirudh Kamath
c062ab8b0a
[chore] update links in readme for slack and rm npm pill (#455)
* Update README.md

* Update README.md
2025-02-02 19:35:04 -08:00
Anirudh Kamath
f7ab8da45d
add build (#439) 2025-01-27 22:15:58 -08:00
Sameel
e64522bf46
Update README to reflect new syntax (#420) 2025-01-21 07:55:41 -08:00
Anirudh Kamath
ec8989b871
incorporate feedback on readme (#410)
* add a code sample to the readme

* indent

* indent

* act

* add section on how it works

* remove bb from readme

* why

* final
2025-01-17 18:32:08 -08:00
Anirudh Kamath
0721318dd8
add #1 trending badge (#407)
* add #1 trending badge

* extra line lol
2025-01-14 19:29:01 -08:00
Anirudh Kamath
2cee0a45ae
add demo (#386)
* add demo

* center align

* add changeset
2025-01-08 08:30:56 -08:00
Anirudh Kamath
30e7d09144
add branding to readme and link to docs (#371)
* add branding to readme

* logo

* light/dark mode

* better light/dark mode

* logo

* changeset

* remove license link

* link to mit license

* add branding to readme

* logo

* light/dark mode

* better light/dark mode

* logo

* changeset

* remove license link

* link to mit license

* cleanup readme

* env vars

* more cleanup

* more cleanup

* don't fmt readme

* move prereqs

* available models

* fix note

* cleanup

* axe more

* axe even more

* contributors

* env vars

* need to add contributing guide

* contribution guide

* contributions

* installation

* rm stagehand v. playwright

* temp

* move note

* wording

* lindsay edits

* change interoperable
2025-01-07 22:44:49 -08:00
Anirudh Kamath
08907ebbc2
allow llmClient to be optionally passed in (#352) (#364)
* allow llmClient to be optionally passed in (#352)

* feat: allow llmClient to be optionally passed in

* update: add ollama client example from pr: #349

* update: README and changeset

* lint

---------

Co-authored-by: Arihan Varanasi <63890951+arihanv@users.noreply.github.com>
2025-01-02 22:08:57 -08:00
Anirudh Kamath
cd23fa3345
V2 (#324)
* Use CI on v2 branch

* branch

* add docs, move scoring functions to scoring.ts, move experiment naming to utils.ts

* add initStagehand.ts

* break up index.evals.ts and utils into smaller files

* export LogLineEval

* typing

* follow StagehandConfig pattern

* choose api key based on model name

* stagehand.act -> page.act (#326)

* need to actually move to act to page now

* move act -> page

* fix e2e

* fix tests

* readme

* changeset

* package json and changeset

* don't fail on combo evals

* Add act evals on `stagehand.page` (#328)

* move act evals to stagehand.page

* add basic act and make act necessary in type

* move extract and observe to page (#329)

* move act evals to stagehand.page

* add basic act and make act necessary in type

* move extract and observe

* example

* changeset

* More playwright tests (#330)

* add docs, move scoring functions to scoring.ts, move experiment naming to utils.ts

* add initStagehand.ts

* break up index.evals.ts and utils into smaller files

* export LogLineEval

* typing

* follow StagehandConfig pattern

* choose api key based on model name

* Use CI on v2 branch

* branch

* stagehand.page tests

* dont run on BB

* prettier

* pls dont fail

* headless

---------

Co-authored-by: Anirudh Kamath <github@kamath.io>

* add extract evals for stagehand.page (#331)

* add extract evals for stagehand.page

* fix typign

* smh i didn't actually run extract

* add observe page evals (#332)

* change stagehand.observe to stagehand.page.observe in evals

* changeset

* Browsercontext playwright tests (#334)

* add docs, move scoring functions to scoring.ts, move experiment naming to utils.ts

* add initStagehand.ts

* break up index.evals.ts and utils into smaller files

* export LogLineEval

* typing

* follow StagehandConfig pattern

* choose api key based on model name

* Use CI on v2 branch

* branch

* BrowserContext tests

* file path

---------

Co-authored-by: Anirudh Kamath <github@kamath.io>

* changeset minor

* ci yml

---------

Co-authored-by: seanmcguire12 <seanmcguire1@outlook.com>
Co-authored-by: Sean McGuire <75873287+seanmcguire12@users.noreply.github.com>
2024-12-23 21:10:30 -08:00
Anirudh Kamath
902e633e12
chore: rename browserbaseResumeSessionID -> browserbaseSessionID (#316)
* chore: rename browserbaseResumeSessionID -> browserbaseSessionID

* changeset
2024-12-16 21:53:10 -08:00
Sean McGuire
0b72f75f6a
Extract improvement take 3 (#304)
* update readme

* add bounding box functions to use on the DOM

* add parameterized textExtract

* add formatText function and helpers

* ad TextAnnotation type

* changeset & prettier

* add useTextExtract as param for ExtractOptions

* use textExtract method in CI

* rm NotImplementedError

* indentation fix

* dont run domExtract and textExtract at the same time

* ๐Ÿ“ˆ time limit

* โฌ†๏ธ time limit & rm extract_partners
2024-12-15 21:20:55 -08:00
Anirudh Kamath
55f0cd2fe7
Make BB Session ID public within Stagehand class (#298)
* Add session ID to init result

* add to readme

* changeset

* index ts
2024-12-12 16:28:10 -08:00
Anirudh Kamath
f11da27a20
Tidy: deprecate + rename init/constructor (#296)
* tidy: deprecate fields

* console warn

* update changeset

* mroe cleanup
2024-12-12 12:23:27 -08:00
Anirudh Kamath
529179724a
eslint - final version (#282)
* eslint - final version (#281)

* add eslint (#269)

* add eslint

* update vision typing

* type fixes

* update anthropic types

* update openai types

* fix type errs

* type fixes

* revert args map

* createChatCompletion typing

* eslint ignore dist

* type fixes

* cache/eval type fixes

* update expected type

* add nonsense_action

* changeset

* ignore dom build

* Add eslint edits (#273)

* add eslint

* update vision typing

* type fixes

* update anthropic types

* update openai types

* fix type errs

* type fixes

* revert args map

* createChatCompletion typing

* eslint ignore dist

* type fixes

* cache/eval type fixes

* update expected type

* add nonsense_action

* changeset

* ignore dom build

* remove casting

* add auxillary

* more cleanup

* type cleaning

* type cleaning

* update changeset

* fix last 3 type errs

* Organize evals (#272)

* remove organize-evals

* dont fail CI based on experimental score

* expedia error handling

* evals type safety

---------

Co-authored-by: seanmcguire12 <seanmcguire1@outlook.com>

* ci + prettier

* lint

* add lint as a separate step

---------

Co-authored-by: Sameel <sameel.m.arif@gmail.com>
Co-authored-by: seanmcguire12 <seanmcguire1@outlook.com>
2024-12-08 17:22:31 -08:00
Sameel
6b10b3b116
add close link to readme (#270)
* add close link to readme

* changeset
2024-12-03 09:12:03 -08:00
Sameel
598cae230c
auto delete ctx (#253)
* cleanup function

* changeset

* update readme with close

* close() return type

* update changeset
2024-12-02 17:57:23 -08:00
Anirudh Kamath
b9f9949402
Configure release management (#232)
* Configure release management

* release docs

* add build step

* fixes

* undo wrong ports

* remove private method

* no massive build

* changeset

* rm tsup

* release doc

* minor changeset duplication

* export more types

* rm unnecessary package json

* changeset update

* update release doc

* readme

* readme observe

* add postinstall

* lock

* release md

* readme

* release yml

* undo build

* readme tsup

* link to esbuild

* formatting readme

* broken esbuild link

* revert revert notes/warnings

* one more note reversion:

* stop formatting readme
2024-12-02 15:55:21 -08:00
Sean McGuire
496abc9e07
instructions for running individual evals (#248) 2024-11-29 18:58:42 -08:00
Paul Klein
b9d352cdde
Add side-by-side example for playwright vs stagehand (#235)
* Add side-by-side example for playwright vs stagehand

* Add side by side

* Don't change example

* fix lint
2024-11-26 22:14:32 -08:00
Paul Klein
92d3b6f6c4
Update README and License with missing/incorrect info (#223)
* Fix company name typo in license

* Remove broken evals badge from readme

* Update readme

* save without formatting
2024-11-25 22:29:21 -08:00
Filip Michalsky
47bd540968
add optional granular timeout; (#173)
* add optional granular timeout;

* readme update

* reduce default timeout to 30s
2024-11-09 23:27:45 -05:00
Harsh Gupta
4ef6eb4833
Fix Fuji-Web link in README (#169) 2024-11-07 09:59:16 -08:00
Anirudh Kamath
427a07d131
Update README notes (#165) 2024-11-06 10:12:41 -08:00
Navid Pour
8d42f66fb3
more llm provider caching code (leftover from previous commit) (#161)
* enable caching on example by default

* better cache clean up

* update readme
2024-11-02 15:37:41 -07:00
Navid Pour
399e753ced
add caching on the llm provider level (#157)
* add caching on the llm provider level

* fix the bug in prev commit

* add lock file for caching + clear actions that are unsuccesful at the end

* leftover from prev commit

* disable caching by default

* add cache option for evals + cleanup

* update readme
2024-11-02 15:18:52 -07:00
Filip Michalsky
ecffbb9671
add a simple prompting guide (#138)
* add a simple prompting guide

* Update README.md

---------

Co-authored-by: Paul Klein <paulleoklein@gmail.com>
2024-10-29 01:23:53 -07:00
Jeremy Press
6e62fa7c42
readme tweaks (#137)
* readme tweaks

* Update README.md

---------

Co-authored-by: Paul Klein <paulleoklein@gmail.com>
2024-10-29 01:23:42 -07:00
Paul Klein
9e477f76c0
Update README.md 2024-10-29 00:27:26 -07:00
Paul Klein
1e65d6490f
Update readme with vision information (#135)
* Update readme with vision information

* fix notes

* reduce links for API reference
2024-10-28 04:44:32 -07:00
Paul Klein
3aa80a63a2
Replace pnpm with npm (#134)
* Replace pnpm with npm

* Fix readme
2024-10-28 04:26:29 -07:00
Paul Klein
ab5e2c5940
Add default timeout to waitForSettledDom (#132)
* Add default timeout to waitForSettledDom

* set to 60 second default timeout

* Change to 61 seconds

* Update index.ts

* Update index.ts
2024-10-28 02:17:19 -07:00