From d4c0718295552fe48a07f6680097b2c5f26151e5 Mon Sep 17 00:00:00 2001
From: abrichr <richard.abrich@mldsai.com>
Date: Wed, 26 Aug 2026 00:26:38 -0400
Subject: [PATCH] fix: state the browser extra in quickstart install commands

Plain 'pip install openadapt' does not install Playwright, so the verified quickstart fails with exit 2. The download page, hero, pricing, and developers surfaces now show pip install 'openadapt[browser]'; the public-truth test asserts the literal extra with escaped brackets.
---
 components/Developers.js   |   2 +-
 components/MastHead.js     |   2 +-
 components/Pricing.js      |   2 +-
 pages/download.js          |   6 +++---
 public/openadapt-paper.pdf | Bin 609741 -> 609741 bytes
 tests/publicTruth.test.js  |   2 +-
 6 files changed, 7 insertions(+), 7 deletions(-)

diff --git a/components/Developers.js b/components/Developers.js
index 8f9b1854..17703dc0 100644
--- a/components/Developers.js
+++ b/components/Developers.js
@@ -42,7 +42,7 @@ export default function Developers({ buildWarnings = [], githubStats = null }) {
                         </div>
                     )}
                     <p className="mt-2 mb-6 mx-auto text-center max-w-2xl text-sm text-ink-2">
-                        <code>pip install openadapt</code> is the stable
+                        <code>pip install 'openadapt[browser]'</code> is the stable
                         end-user entry point. The <code>openadapt-flow</code>{' '}
                         engine records a workflow, compiles it into a
                         reviewable program, and replays it locally with no model
diff --git a/components/MastHead.js b/components/MastHead.js
index f3aae9f2..25bdde82 100644
--- a/components/MastHead.js
+++ b/components/MastHead.js
@@ -97,7 +97,7 @@ export default function Home({ githubStats: initialGithubStats }) {
                                 </p>
                                 <p className="mb-8 text-sm leading-relaxed text-ink-3">
                                     <code className="rounded border border-hairline bg-panel px-2 py-1 text-ink">
-                                        pip install openadapt
+                                        pip install 'openadapt[browser]'
                                     </code>
                                     <span aria-hidden="true"> · </span>
                                     <Link
diff --git a/components/Pricing.js b/components/Pricing.js
index ea62170b..5b54e180 100644
--- a/components/Pricing.js
+++ b/components/Pricing.js
@@ -235,7 +235,7 @@ export default function Pricing({ hostedOffer = null }) {
                             Run the open-source demo
                         </a>
                         <p className="mt-3 text-center font-mono text-xs text-ink-3">
-                            pip install openadapt
+                            pip install 'openadapt[browser]'
                         </p>
                     </EntryCard>
 
diff --git a/pages/download.js b/pages/download.js
index 1809a6f6..a00f90f8 100644
--- a/pages/download.js
+++ b/pages/download.js
@@ -142,7 +142,7 @@ export default function DownloadPage({ release, fetchFailed }) {
                     Windows, macOS, and Linux.
                 </p>
                 <pre className="mt-6 max-w-2xl overflow-x-auto rounded-xl border border-hairline bg-panel p-4 font-mono text-sm text-ink">
-                    <code>pip install openadapt</code>
+                    <code>pip install 'openadapt[browser]'</code>
                 </pre>
 
                 <div className="mt-6 flex flex-wrap gap-3">
@@ -269,7 +269,7 @@ export default function DownloadPage({ release, fetchFailed }) {
                             <p className="mt-2 max-w-2xl text-sm text-ink-2">
                                 The next complete Beta set has not been
                                 published yet. Use{' '}
-                                <code>pip install openadapt</code>, or watch the
+                                <code>pip install 'openadapt[browser]'</code>, or watch the
                                 desktop releases page for the native build.
                             </p>
                             <div className="mt-4 flex flex-wrap gap-3">
@@ -522,7 +522,7 @@ export default function DownloadPage({ release, fetchFailed }) {
                         Need the working workflow engine?
                     </h2>
                     <p className="mx-auto mt-3 max-w-2xl text-sm text-ink-2 md:text-base">
-                        Start with <code>pip install openadapt</code>, or bring the workflow
+                        Start with <code>pip install 'openadapt[browser]'</code>, or bring the workflow
                         you most want to automate to a 30-minute call.
                     </p>
                     <div className="mt-5 flex flex-wrap justify-center gap-3">
diff --git a/public/openadapt-paper.pdf b/public/openadapt-paper.pdf
index a1d5e72e7407c3d5789d79ef3c3f4d49744ac71d..db45a09dfc6498cb3e1d30a66630d61227bb15d9 100644
GIT binary patch
delta 144
zcmX>*TlMU0)rJ<v7N!>F7M2#)7Pc1l7LF~POI%cp4NVM93@oBFx%7SWQ(O{DQWZ2@
ztc(nd%nU4yppx59xNuHjb~ZFNG;nruHL-McG&eG_G%+!Ev2b-WH!(DKbv1W#wXjpL
NA*5vcY!6N&Rsd!&C9VJf

delta 144
zcmX>*TlMU0)rJ<v7N!>F7M2#)7Pc1l7LF~POI%cp3{8!U42_~Rx%7SWQ(O{DQWZ2@
ztc(nd%nU4m5@5;gCtNruFgqKW8XH?WIXgKS8o64UIJsGxn>o8VnVLFUT9_JGxSH50
O*bq{(eYOXu5i0;?E+w7-

diff --git a/tests/publicTruth.test.js b/tests/publicTruth.test.js
index 429304d9..60bb0346 100644
--- a/tests/publicTruth.test.js
+++ b/tests/publicTruth.test.js
@@ -164,7 +164,7 @@ test('end-user quickstarts enter through OpenAdapt while engine links stay techn
     const developerLinks = read('data/developerLinks.js')
     const publicSurfaces = [install, pricing, templates, download].join('\n')
 
-    assert.match(publicSurfaces, /pip install openadapt/)
+    assert.match(publicSurfaces, /pip install 'openadapt\[browser\]'/)
     assert.match(publicSurfaces, /openadapt flow/)
     assert.doesNotMatch(publicSurfaces, /pip install openadapt-flow/)
     assert.doesNotMatch(publicSurfaces, /uv tool uninstall openadapt/)