Skip to content

Add Python SDK beta documentation page#1775

Merged
pranaygp merged 9 commits into
mainfrom
v0/pranaygp-97a9e7c4
Apr 16, 2026
Merged

Add Python SDK beta documentation page#1775
pranaygp merged 9 commits into
mainfrom
v0/pranaygp-97a9e7c4

Conversation

@pranaygp
Copy link
Copy Markdown
Contributor

Adds a dedicated Python SDK page to the Getting Started section of the docs, as discussed for the launch.

What changed

  • Created /docs/getting-started/python.mdx with content sourced from vercel.com/docs/workflow/concepts
  • Added a prominent beta warning callout at the top of the page
  • Added a "Beta" badge pill to the Python SDK card in the Getting Started index
  • Created a Python logo SVG icon and exported it from the frameworks component
  • Positioned the Python SDK card first in the Getting Started grid to highlight it

The page covers core concepts (Workflow, Step, Sleep, Hook, Skew Protection) with Python code samples and links back to the official Vercel docs.

Slack Thread

Copilot AI review requested due to automatic review settings April 16, 2026 16:19
@pranaygp pranaygp requested a review from a team as a code owner April 16, 2026 16:19
@pranaygp pranaygp added the v0 label Apr 16, 2026 — with Vercel
@changeset-bot
Copy link
Copy Markdown

changeset-bot Bot commented Apr 16, 2026

⚠️ No Changeset found

Latest commit: ce26467

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 16, 2026

🧪 E2E Test Results

Some tests failed

Summary

Passed Failed Skipped Total
❌ ▲ Vercel Production 870 53 67 990
✅ 💻 Local Development 994 0 86 1080
✅ 📦 Local Production 994 0 86 1080
✅ 🐘 Local Postgres 994 0 86 1080
✅ 🪟 Windows 90 0 0 90
❌ 🌍 Community Worlds 133 98 0 231
✅ 📋 Other 252 0 18 270
Total 4327 151 343 4821

❌ Failed Tests

▲ Vercel Production (53 failed)

astro (5 failed):

  • DurableAgent e2e core tool error recovery
  • DurableAgent e2e multimodal tool results passes through LanguageModelV3ToolResultOutput from tools
  • DurableAgent e2e tool approval (GAP) completes but needsApproval is not checked (GAP)
  • promiseRaceStressTestWorkflow | wrun_01KPBKZ3T56MR22WVY9K344AGD | 🔍 observability
  • health check (CLI) - workflow health command reports healthy endpoints

example (7 failed):

  • DurableAgent e2e core single tool call
  • DurableAgent e2e core multiple sequential tool calls
  • DurableAgent e2e experimental_onToolCallStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e prepareCall (GAP) completes but prepareCall is not applied (GAP)
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow negative startIndex (reads from end)
  • error handling retry behavior FatalError fails immediately without retries

fastify (3 failed):

  • DurableAgent e2e experimental_onStart (GAP) completes but callbacks are not called (GAP)
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamWorkflow positive startIndex (skips first chunk)

hono (3 failed):

  • DurableAgent e2e experimental_onStepStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e prepareStep on constructor agent-level prepareStep is called for each LLM step
  • pathsAliasWorkflow - TypeScript path aliases resolve correctly | wrun_01KPBM6HTZBKJ9D7ZAMFJAK2Z8 | 🔍 observability

nextjs-turbopack (6 failed):

  • DurableAgent e2e onStepFinish fires constructor + stream callbacks in order with step data
  • DurableAgent e2e experimental_onToolCallStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e prepareCall (GAP) completes but prepareCall is not applied (GAP)
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • error handling error propagation step errors cross-file step error preserves message and function names in stack
  • error handling not registered StepNotRegisteredError fails the step but workflow can catch it

nextjs-webpack (4 failed):

  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow negative startIndex (reads from end)
  • outputStreamInsideStepWorkflow - getWritable() called inside step functions | wrun_01KPBKX5E01950J6R6FCR7RA6B | 🔍 observability
  • promiseRaceStressTestWorkflow | wrun_01KPBKZ3T56MR22WVY9K344AGD | 🔍 observability

nitro (6 failed):

  • DurableAgent e2e experimental_onStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e experimental_onToolCallStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e prepareStep on constructor agent-level prepareStep is called for each LLM step
  • DurableAgent e2e prepareStep on constructor stream-level prepareStep overrides constructor-level
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamWorkflow negative startIndex (reads from end)

nuxt (7 failed):

  • DurableAgent e2e experimental_onToolCallFinish (GAP) completes but callbacks are not called (GAP)
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns correct index after stream completes
  • outputStreamWorkflow - getTailIndex and getChunks getChunks returns same content as reading the stream
  • outputStreamInsideStepWorkflow - getWritable() called inside step functions | wrun_01KPBKX5E01950J6R6FCR7RA6B | 🔍 observability
  • error handling catchability FatalError can be caught and detected with FatalError.is()

sveltekit (9 failed):

  • DurableAgent e2e experimental_onStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e experimental_onToolCallStart (GAP) completes but callbacks are not called (GAP)
  • DurableAgent e2e tool approval (GAP) completes but needsApproval is not checked (GAP)
  • webhookWorkflow | wrun_01KPBKQAQ6Y3VSPVGC81VYW4CB | 🔍 observability
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns correct index after stream completes
  • outputStreamWorkflow - getTailIndex and getChunks getChunks returns same content as reading the stream
  • fetchWorkflow | wrun_01KPBKZ0KB8JX06S6YXS8M1JPT | 🔍 observability
  • crossContextSerdeWorkflow - classes defined in step code are deserializable in workflow context | wrun_01KPBM8SQWSASQYH14CT7V6ZBX | 🔍 observability

vite (3 failed):

  • DurableAgent e2e timeout completes within timeout
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamInsideStepWorkflow - getWritable() called inside step functions | wrun_01KPBKX5E01950J6R6FCR7RA6B | 🔍 observability
🌍 Community Worlds (98 failed)

mongodb (15 failed):

  • readableStreamWorkflow | wrun_01KPBKPCYR0JFZJ4KTNYMFZG97
  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KPBKQ1RH3R87HC7BVDHVEJ84
  • webhookWorkflow | wrun_01KPBKQAQ6Y3VSPVGC81VYW4CB
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow negative startIndex (reads from end)
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns correct index after stream completes
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns -1 before any chunks are written
  • outputStreamWorkflow - getTailIndex and getChunks getChunks returns same content as reading the stream
  • outputStreamInsideStepWorkflow - getWritable() called inside step functions | wrun_01KPBKX5E01950J6R6FCR7RA6B
  • fetchWorkflow | wrun_01KPBKZ0KB8JX06S6YXS8M1JPT
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KPBM3BQCNQCWDD9SAJDDS023
  • health check (queue-based) - workflow and step endpoints respond to health check messages
  • health check (CLI) - workflow health command reports healthy endpoints
  • resilient start: addTenWorkflow completes when run_created returns 500 | wrun_01KPBMBKFP0NRNBYQRJEXGMS15

redis (15 failed):

  • readableStreamWorkflow | wrun_01KPBKPCYR0JFZJ4KTNYMFZG97
  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KPBKQ1RH3R87HC7BVDHVEJ84
  • webhookWorkflow | wrun_01KPBKQAQ6Y3VSPVGC81VYW4CB
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow negative startIndex (reads from end)
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns correct index after stream completes
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns -1 before any chunks are written
  • outputStreamWorkflow - getTailIndex and getChunks getChunks returns same content as reading the stream
  • outputStreamInsideStepWorkflow - getWritable() called inside step functions | wrun_01KPBKX5E01950J6R6FCR7RA6B
  • fetchWorkflow | wrun_01KPBKZ0KB8JX06S6YXS8M1JPT
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KPBM3BQCNQCWDD9SAJDDS023
  • health check (queue-based) - workflow and step endpoints respond to health check messages
  • health check (CLI) - workflow health command reports healthy endpoints
  • resilient start: addTenWorkflow completes when run_created returns 500 | wrun_01KPBMBKFP0NRNBYQRJEXGMS15

turso (68 failed):

  • addTenWorkflow | wrun_01KPBKNVYD2VYKHF2J21M247ZV
  • addTenWorkflow | wrun_01KPBKNVYD2VYKHF2J21M247ZV
  • wellKnownAgentWorkflow (.well-known/agent) | wrun_01KPBKNM8JZXMXFM7J7228TJSY
  • should work with react rendering in step
  • promiseAllWorkflow | wrun_01KPBKP3BBX7FDYJG98G9TW798
  • promiseRaceWorkflow | wrun_01KPBKP8D7TABHJQ64SM2S1H4K
  • promiseAnyWorkflow | wrun_01KPBKPASX14QY3Y3W04K388A7
  • importedStepOnlyWorkflow | wrun_01KPBKNZ1APEKSDGZCPV8N1MGB
  • readableStreamWorkflow | wrun_01KPBKPCYR0JFZJ4KTNYMFZG97
  • hookWorkflow | wrun_01KPBKPPKARZZ9TQWVFAAF1MQT
  • hookWorkflow is not resumable via public webhook endpoint | wrun_01KPBKQ1RH3R87HC7BVDHVEJ84
  • webhookWorkflow | wrun_01KPBKQAQ6Y3VSPVGC81VYW4CB
  • sleepingWorkflow | wrun_01KPBKQQYHBQ8GGS0WFM5EW2QP
  • parallelSleepWorkflow | wrun_01KPBKR65DEV8CPFQN4SGA5JPV
  • nullByteWorkflow | wrun_01KPBKRD3ARMPQ8585MHVAYV7H
  • workflowAndStepMetadataWorkflow | wrun_01KPBKRT5N948FMVMP71DMEPFS
  • outputStreamWorkflow no startIndex (reads all chunks)
  • outputStreamWorkflow positive startIndex (skips first chunk)
  • outputStreamWorkflow negative startIndex (reads from end)
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns correct index after stream completes
  • outputStreamWorkflow - getTailIndex and getChunks getTailIndex returns -1 before any chunks are written
  • outputStreamWorkflow - getTailIndex and getChunks getChunks returns same content as reading the stream
  • outputStreamInsideStepWorkflow - getWritable() called inside step functions | wrun_01KPBKX5E01950J6R6FCR7RA6B
  • fetchWorkflow | wrun_01KPBKZ0KB8JX06S6YXS8M1JPT
  • promiseRaceStressTestWorkflow | wrun_01KPBKZ3T56MR22WVY9K344AGD
  • error handling error propagation workflow errors nested function calls preserve message and stack trace
  • error handling error propagation workflow errors cross-file imports preserve message and stack trace
  • error handling error propagation step errors basic step error preserves message and stack trace
  • error handling error propagation step errors cross-file step error preserves message and function names in stack
  • error handling retry behavior regular Error retries until success
  • error handling retry behavior FatalError fails immediately without retries
  • error handling retry behavior RetryableError respects custom retryAfter delay
  • error handling retry behavior maxRetries=0 disables retries
  • error handling catchability FatalError can be caught and detected with FatalError.is()
  • error handling not registered WorkflowNotRegisteredError fails the run when workflow does not exist
  • error handling not registered StepNotRegisteredError fails the step but workflow can catch it
  • error handling not registered StepNotRegisteredError fails the run when not caught in workflow
  • hookCleanupTestWorkflow - hook token reuse after workflow completion | wrun_01KPBM2Q70DPF84J9T12D7FRA9
  • concurrent hook token conflict - two workflows cannot use the same hook token simultaneously | wrun_01KPBM3BQCNQCWDD9SAJDDS023
  • hookDisposeTestWorkflow - hook token reuse after explicit disposal while workflow still running | wrun_01KPBM3ZE50BYA116RG2FXQC9B
  • stepFunctionPassingWorkflow - step function references can be passed as arguments (without closure vars) | wrun_01KPBM4KJ04PM3DCESZ76EQYHE
  • stepFunctionWithClosureWorkflow - step function with closure variables passed as argument | wrun_01KPBM4Z3V1W9WA8SG9QR191GH
  • closureVariableWorkflow - nested step functions with closure variables | wrun_01KPBM54B1Q9C4R5D2KWS8PZKT
  • spawnWorkflowFromStepWorkflow - spawning a child workflow using start() inside a step | wrun_01KPBM56DZFHR6K9KERBSKQK5H
  • runClassSerializationWorkflow - Run instances serialize across workflow/step boundaries | wrun_01KPBM647YAR7KYE0D2JWNHFBD
  • health check (queue-based) - workflow and step endpoints respond to health check messages
  • health check (CLI) - workflow health command reports healthy endpoints
  • pathsAliasWorkflow - TypeScript path aliases resolve correctly | wrun_01KPBM6HTZBKJ9D7ZAMFJAK2Z8
  • Calculator.calculate - static workflow method using static step methods from another class | wrun_01KPBM6Q2DRMWCYY9DDZNS6DQQ
  • AllInOneService.processNumber - static workflow method using sibling static step methods | wrun_01KPBM7ERP71BC3V7TXS1G1EK0
  • ChainableService.processWithThis - static step methods using this to reference the class | wrun_01KPBM7N1R9BGT1X71EJKPV00J
  • thisSerializationWorkflow - step function invoked with .call() and .apply() | wrun_01KPBM7YYCVJ5BBHD1C12KGZ6R
  • customSerializationWorkflow - custom class serialization with WORKFLOW_SERIALIZE/WORKFLOW_DESERIALIZE | wrun_01KPBM85KHAVE5T8TQ6EWWJ6TV
  • instanceMethodStepWorkflow - instance methods with "use step" directive | wrun_01KPBM8CZXBPEXTJCVA2C11W45
  • crossContextSerdeWorkflow - classes defined in step code are deserializable in workflow context | wrun_01KPBM8SQWSASQYH14CT7V6ZBX
  • stepFunctionAsStartArgWorkflow - step function reference passed as start() argument | wrun_01KPBM971RK4N5ENNZWAV0J02V
  • cancelRun - cancelling a running workflow | wrun_01KPBM9EDSN9EKVEF5JYZ0MCZ3
  • cancelRun via CLI - cancelling a running workflow | wrun_01KPBM9QX9BPBEE72F404HP5C3
  • pages router addTenWorkflow via pages router
  • pages router promiseAllWorkflow via pages router
  • pages router sleepingWorkflow via pages router
  • hookWithSleepWorkflow - hook payloads delivered correctly with concurrent sleep | wrun_01KPBMA3C30Z7WP6VFMGYBJ1TB
  • sleepInLoopWorkflow - sleep inside loop with steps actually delays each iteration | wrun_01KPBMARH8EP899SPBPERB65BA
  • sleepWithSequentialStepsWorkflow - sequential steps work with concurrent sleep (control) | wrun_01KPBMB496Y2QG007T08PKZ9S3
  • importMetaUrlWorkflow - import.meta.url is available in step bundles | wrun_01KPBMBE511E5B94PKK1KFCCYT
  • metadataFromHelperWorkflow - getWorkflowMetadata/getStepMetadata work from module-level helper (#1577) | wrun_01KPBMBHCKKR1MAKA6046SXY5G
  • resilient start: addTenWorkflow completes when run_created returns 500 | wrun_01KPBMBKFP0NRNBYQRJEXGMS15
  • getterStepWorkflow - getter functions with "use step" directive | wrun_01KPBMBPPV4S88F0STZ73SD20B

Details by Category

❌ ▲ Vercel Production
App Passed Failed Skipped
❌ astro 78 5 7
❌ example 76 7 7
✅ express 83 0 7
❌ fastify 80 3 7
❌ hono 80 3 7
❌ nextjs-turbopack 82 6 2
❌ nextjs-webpack 84 4 2
❌ nitro 77 6 7
❌ nuxt 76 7 7
❌ sveltekit 74 9 7
❌ vite 80 3 7
✅ 💻 Local Development
App Passed Failed Skipped
✅ astro-stable 84 0 6
✅ express-stable 84 0 6
✅ fastify-stable 84 0 6
✅ hono-stable 84 0 6
✅ nextjs-turbopack-canary 71 0 19
✅ nextjs-turbopack-stable 90 0 0
✅ nextjs-webpack-canary 71 0 19
✅ nextjs-webpack-stable 90 0 0
✅ nitro-stable 84 0 6
✅ nuxt-stable 84 0 6
✅ sveltekit-stable 84 0 6
✅ vite-stable 84 0 6
✅ 📦 Local Production
App Passed Failed Skipped
✅ astro-stable 84 0 6
✅ express-stable 84 0 6
✅ fastify-stable 84 0 6
✅ hono-stable 84 0 6
✅ nextjs-turbopack-canary 71 0 19
✅ nextjs-turbopack-stable 90 0 0
✅ nextjs-webpack-canary 71 0 19
✅ nextjs-webpack-stable 90 0 0
✅ nitro-stable 84 0 6
✅ nuxt-stable 84 0 6
✅ sveltekit-stable 84 0 6
✅ vite-stable 84 0 6
✅ 🐘 Local Postgres
App Passed Failed Skipped
✅ astro-stable 84 0 6
✅ express-stable 84 0 6
✅ fastify-stable 84 0 6
✅ hono-stable 84 0 6
✅ nextjs-turbopack-canary 71 0 19
✅ nextjs-turbopack-stable 90 0 0
✅ nextjs-webpack-canary 71 0 19
✅ nextjs-webpack-stable 90 0 0
✅ nitro-stable 84 0 6
✅ nuxt-stable 84 0 6
✅ sveltekit-stable 84 0 6
✅ vite-stable 84 0 6
✅ 🪟 Windows
App Passed Failed Skipped
✅ nextjs-turbopack 90 0 0
❌ 🌍 Community Worlds
App Passed Failed Skipped
✅ mongodb-dev 6 0 0
❌ mongodb 56 15 0
✅ redis-dev 6 0 0
❌ redis 56 15 0
✅ turso-dev 6 0 0
❌ turso 3 68 0
✅ 📋 Other
App Passed Failed Skipped
✅ e2e-local-dev-nest-stable 84 0 6
✅ e2e-local-postgres-nest-stable 84 0 6
✅ e2e-local-prod-nest-stable 84 0 6

📋 View full workflow run


Some E2E test jobs failed:

  • Vercel Prod: failure
  • Local Dev: success
  • Local Prod: success
  • Local Postgres: success
  • Windows: success

Check the workflow run for details.

@github-actions
Copy link
Copy Markdown
Contributor

github-actions Bot commented Apr 16, 2026

📊 Benchmark Results

📈 Comparing against baseline from main branch. Green 🟢 = faster, Red 🔺 = slower.

workflow with no steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Express 0.044s (+26.9% 🔺) 1.005s (~) 0.961s 10 1.00x
💻 Local Nitro 0.046s (+27.2% 🔺) 1.006s (~) 0.961s 10 1.03x
🐘 Postgres Nitro 0.059s (-2.1%) 1.010s (~) 0.951s 10 1.34x
🐘 Postgres Express 0.060s (-16.3% 🟢) 1.011s (-0.9%) 0.950s 10 1.36x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 0.288s (+18.9% 🔺) 2.369s (+15.8% 🔺) 2.081s 10 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 1 step

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
💻 Local 🥇 Express 1.133s (+3.2%) 2.006s (~) 0.873s 10 1.00x
💻 Local Nitro 1.134s (+3.0%) 2.006s (~) 0.872s 10 1.00x
🐘 Postgres Nitro 1.142s (~) 2.011s (~) 0.868s 10 1.01x
🐘 Postgres Express 1.148s (~) 2.012s (~) 0.864s 10 1.01x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 4.610s (+101.7% 🔺) 6.260s (+57.3% 🔺) 1.650s 10 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 10 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 10.889s (~) 11.019s (~) 0.130s 3 1.00x
🐘 Postgres Express 10.918s (-0.6%) 11.021s (-2.9%) 0.103s 3 1.00x
💻 Local Express 10.960s (+2.9%) 11.023s (~) 0.064s 3 1.01x
💻 Local Nitro 10.989s (+3.2%) 11.024s (~) 0.034s 3 1.01x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 331.093s (+1712.9% 🔺) 332.815s (+1515.3% 🔺) 1.722s 1 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 25 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 14.515s (-0.6%) 15.019s (~) 0.504s 4 1.00x
🐘 Postgres Nitro 14.555s (~) 15.027s (~) 0.472s 4 1.00x
💻 Local Nitro 15.018s (+5.4% 🔺) 15.531s (+3.3%) 0.513s 4 1.03x
💻 Local Express 15.122s (+6.2% 🔺) 16.032s (+6.7% 🔺) 0.910s 4 1.04x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 60.606s (+90.5% 🔺) 63.322s (+88.0% 🔺) 2.716s 1 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 50 sequential steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 14.022s (-2.2%) 14.451s (-3.8%) 0.429s 7 1.00x
🐘 Postgres Nitro 14.652s (+5.1% 🔺) 15.364s (+9.6% 🔺) 0.712s 6 1.04x
💻 Local Nitro 16.489s (+10.2% 🔺) 17.032s (+10.9% 🔺) 0.543s 6 1.18x
💻 Local Express 17.046s (+14.4% 🔺) 17.533s (+16.7% 🔺) 0.487s 6 1.22x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 83.749s (+54.5% 🔺) 94.706s (+67.8% 🔺) 10.957s 1 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Promise.all with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.275s (-1.4%) 2.011s (~) 0.736s 15 1.00x
🐘 Postgres Nitro 1.289s (+1.9%) 2.010s (~) 0.721s 15 1.01x
💻 Local Nitro 1.531s (+3.7%) 2.006s (~) 0.475s 15 1.20x
💻 Local Express 1.544s (+5.8% 🔺) 2.006s (~) 0.462s 15 1.21x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 8.500s (+206.0% 🔺) 10.063s (+130.8% 🔺) 1.563s 5 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Promise.all with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 2.332s (-1.0%) 3.010s (~) 0.678s 10 1.00x
🐘 Postgres Nitro 2.361s (+1.0%) 3.011s (~) 0.650s 10 1.01x
💻 Local Nitro 2.907s (+13.5% 🔺) 3.454s (+14.8% 🔺) 0.546s 9 1.25x
💻 Local Express 3.155s (+11.0% 🔺) 3.884s (+25.0% 🔺) 0.730s 8 1.35x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 12.977s (+354.4% 🔺) 14.377s (+215.4% 🔺) 1.400s 5 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Promise.all with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 3.473s (~) 4.013s (~) 0.540s 8 1.00x
🐘 Postgres Nitro 3.499s (+1.3%) 4.011s (~) 0.512s 8 1.01x
💻 Local Nitro 7.469s (+7.5% 🔺) 8.019s (+6.7% 🔺) 0.550s 4 2.15x
💻 Local Express 9.082s (+28.1% 🔺) 10.023s (+25.0% 🔺) 0.941s 3 2.62x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 5.137s (+48.1% 🔺) 6.737s (+30.8% 🔺) 1.600s 6 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Promise.race with 10 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 1.265s (+0.7%) 2.009s (~) 0.745s 15 1.00x
🐘 Postgres Nitro 1.270s (+0.9%) 2.009s (~) 0.739s 15 1.00x
💻 Local Nitro 1.566s (+3.3%) 2.006s (~) 0.439s 15 1.24x
💻 Local Express 1.572s (+6.8% 🔺) 2.006s (~) 0.435s 15 1.24x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 3.541s (+44.3% 🔺) 5.111s (+25.9% 🔺) 1.570s 6 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Promise.race with 25 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 2.329s (~) 3.010s (~) 0.681s 10 1.00x
🐘 Postgres Express 2.346s (~) 3.011s (~) 0.665s 10 1.01x
💻 Local Nitro 2.889s (+4.4%) 3.008s (-3.3%) 0.119s 10 1.24x
💻 Local Express 3.353s (+24.3% 🔺) 3.884s (+29.2% 🔺) 0.531s 8 1.44x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 11.131s (+213.0% 🔺) 13.029s (+143.3% 🔺) 1.898s 3 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Promise.race with 50 concurrent steps

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 3.447s (-1.1%) 4.010s (~) 0.564s 8 1.00x
🐘 Postgres Express 3.479s (~) 4.013s (~) 0.533s 8 1.01x
💻 Local Nitro 8.018s (+7.7% 🔺) 8.525s (+6.3% 🔺) 0.507s 4 2.33x
💻 Local Express 9.311s (+21.7% 🔺) 10.022s (+25.0% 🔺) 0.710s 3 2.70x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 7.004s (+73.3% 🔺) 8.936s (+47.4% 🔺) 1.932s 5 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 10 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.812s (~) 1.024s (~) 0.212s 59 1.00x
🐘 Postgres Express 0.830s (-1.9%) 1.023s (~) 0.192s 59 1.02x
💻 Local Express 1.016s (+42.8% 🔺) 1.854s (+81.6% 🔺) 0.838s 33 1.25x
💻 Local Nitro 1.028s (+47.8% 🔺) 1.854s (+84.6% 🔺) 0.826s 33 1.27x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 21.357s (+136.8% 🔺) 23.123s (+109.1% 🔺) 1.766s 3 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 25 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.930s (~) 2.174s (+3.5%) 0.244s 42 1.00x
🐘 Postgres Express 1.961s (-5.9% 🟢) 2.203s (-25.2% 🟢) 0.241s 41 1.02x
💻 Local Nitro 3.049s (+34.9% 🔺) 3.843s (+27.7% 🔺) 0.794s 24 1.58x
💻 Local Express 3.057s (+35.3% 🔺) 3.923s (+30.4% 🔺) 0.866s 23 1.58x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 77.046s (+155.6% 🔺) 81.873s (+152.5% 🔺) 4.826s 2 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 50 sequential data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 3.923s (+1.2%) 4.183s (+1.8%) 0.259s 29 1.00x
🐘 Postgres Express 4.028s (-2.2%) 4.568s (-6.6% 🟢) 0.540s 27 1.03x
💻 Local Nitro 9.078s (+23.4% 🔺) 9.557s (+19.2% 🔺) 0.479s 13 2.31x
💻 Local Express 9.408s (+28.4% 🔺) 10.019s (+25.0% 🔺) 0.611s 12 2.40x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 279.180s (+135.8% 🔺) 281.660s (+133.7% 🔺) 2.480s 1 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 10 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.279s (-3.0%) 1.007s (~) 0.728s 60 1.00x
🐘 Postgres Express 0.284s (~) 1.007s (~) 0.723s 60 1.02x
💻 Local Nitro 0.597s (+5.4% 🔺) 1.004s (~) 0.407s 60 2.14x
💻 Local Express 0.599s (~) 1.005s (-1.6%) 0.405s 60 2.15x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 29.462s (+1579.8% 🔺) 31.326s (+795.2% 🔺) 1.864s 4 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 25 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.493s (-2.2%) 1.006s (~) 0.513s 90 1.00x
🐘 Postgres Express 0.516s (+4.4%) 1.007s (~) 0.491s 90 1.05x
💻 Local Express 2.607s (+5.9% 🔺) 3.009s (~) 0.402s 30 5.29x
💻 Local Nitro 2.667s (+9.7% 🔺) 3.181s (+5.8% 🔺) 0.514s 29 5.41x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 4.007s (+46.8% 🔺) 5.844s (+31.4% 🔺) 1.837s 16 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

workflow with 50 concurrent data payload steps (10KB)

💻 Local Development

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.788s (-1.7%) 1.007s (~) 0.219s 120 1.00x
🐘 Postgres Express 0.825s (+1.6%) 1.010s (-0.8%) 0.185s 119 1.05x
💻 Local Nitro 10.898s (+5.6% 🔺) 11.299s (+3.3%) 0.401s 11 13.82x
💻 Local Express 11.422s (+7.9% 🔺) 12.030s (+9.1% 🔺) 0.608s 10 14.49x

▲ Production (Vercel)

World Framework Workflow Time Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 8.630s (+27.3% 🔺) 10.531s (+22.3% 🔺) 1.901s 12 1.00x
▲ Vercel Express ⚠️ missing - - - -

🔍 Observability: Nitro

Stream Benchmarks (includes TTFB metrics)
workflow with stream

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Express 0.209s (-2.8%) 0.996s (~) 0.001s (-31.3% 🟢) 1.010s (~) 0.801s 10 1.00x
💻 Local Nitro 0.209s (+47.7% 🔺) 1.004s (~) 0.010s (-1.0%) 1.016s (~) 0.807s 10 1.00x
💻 Local Express 0.211s (+49.5% 🔺) 1.005s (~) 0.013s (+33.0% 🔺) 1.019s (~) 0.808s 10 1.01x
🐘 Postgres Nitro 0.227s (+5.9% 🔺) 0.999s (~) 0.001s (+7.7% 🔺) 1.010s (~) 0.783s 10 1.08x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 7.321s (+370.2% 🔺) 5.622s (+96.7% 🔺) 1.299s (+32.9% 🔺) 10.677s (+149.7% 🔺) 3.356s 10 1.00x
▲ Vercel Express ⚠️ missing - - - - -

🔍 Observability: Nitro

stream pipeline with 5 transform steps (1MB)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.607s (-1.9%) 1.004s (~) 0.004s (-2.1%) 1.022s (~) 0.415s 59 1.00x
🐘 Postgres Express 0.631s (-1.5%) 1.007s (~) 0.004s (-5.7% 🟢) 1.023s (~) 0.392s 59 1.04x
💻 Local Express 0.768s (+15.2% 🔺) 1.012s (~) 0.010s (+10.2% 🔺) 1.025s (-8.1% 🟢) 0.256s 59 1.27x
💻 Local Nitro 0.776s (+34.3% 🔺) 1.012s (~) 0.011s (+21.4% 🔺) 1.026s (~) 0.250s 59 1.28x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 14.022s (+227.8% 🔺) 16.222s (+178.3% 🔺) 0.865s (+147.3% 🔺) 17.548s (+165.4% 🔺) 3.527s 5 1.00x
▲ Vercel Express ⚠️ missing - - - - -

🔍 Observability: Nitro

10 parallel streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 0.970s (-1.0%) 1.272s (~) 0.000s (+144.7% 🔺) 1.285s (-1.7%) 0.315s 47 1.00x
🐘 Postgres Express 0.991s (+1.1%) 1.358s (+13.4% 🔺) 0.000s (-100.0% 🟢) 1.380s (+13.4% 🔺) 0.390s 44 1.02x
💻 Local Nitro 1.269s (+7.5% 🔺) 2.024s (~) 0.000s (~) 2.027s (~) 0.757s 30 1.31x
💻 Local Express 1.288s (+9.2% 🔺) 2.024s (~) 0.001s (+122.2% 🔺) 2.027s (~) 0.738s 30 1.33x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 4.413s (+56.7% 🔺) 5.929s (+40.7% 🔺) 0.000s (NaN%) 6.454s (+39.2% 🔺) 2.041s 10 1.00x
▲ Vercel Express ⚠️ missing - - - - -

🔍 Observability: Nitro

fan-out fan-in 10 streams (1MB each)

💻 Local Development

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
🐘 Postgres 🥇 Nitro 1.817s (+4.4%) 2.100s (-1.9%) 0.000s (-3.4%) 2.124s (-1.3%) 0.307s 29 1.00x
🐘 Postgres Express 1.848s (+4.6%) 2.144s (~) 0.000s (-100.0% 🟢) 2.183s (+1.6%) 0.335s 28 1.02x
💻 Local Nitro 3.463s (-7.8% 🟢) 4.033s (-3.2%) 0.001s (-20.0% 🟢) 4.036s (-3.2%) 0.573s 15 1.91x
💻 Local Express 3.785s (+7.9% 🔺) 4.234s (+5.0% 🔺) 0.000s (+60.0% 🔺) 4.236s (+5.1% 🔺) 0.451s 15 2.08x

▲ Production (Vercel)

World Framework Workflow Time TTFB Slurp Wall Time Overhead Samples vs Fastest
▲ Vercel 🥇 Nitro 8.328s (+96.3% 🔺) 9.823s (+74.7% 🔺) 0.000s (-100.0% 🟢) 10.296s (+70.6% 🔺) 1.968s 6 1.00x
▲ Vercel Express ⚠️ missing - - - - -

🔍 Observability: Nitro

Summary

Fastest Framework by World

Winner determined by most benchmark wins

World 🥇 Fastest Framework Wins
💻 Local Nitro 15/21
🐘 Postgres Nitro 14/21
▲ Vercel Nitro 21/21
Fastest World by Framework

Winner determined by most benchmark wins

Framework 🥇 Fastest World Wins
Express 🐘 Postgres 19/21
Nitro 🐘 Postgres 18/21
Column Definitions
  • Workflow Time: Runtime reported by workflow (completedAt - createdAt) - primary metric
  • TTFB: Time to First Byte - time from workflow start until first stream byte received (stream benchmarks only)
  • Slurp: Time from first byte to complete stream consumption (stream benchmarks only)
  • Wall Time: Total testbench time (trigger workflow + poll for result)
  • Overhead: Testbench overhead (Wall Time - Workflow Time)
  • Samples: Number of benchmark iterations run
  • vs Fastest: How much slower compared to the fastest configuration for this benchmark

Worlds:

  • 💻 Local: In-memory filesystem world (local development)
  • 🐘 Postgres: PostgreSQL database world (local development)
  • ▲ Vercel: Vercel production/preview deployment
  • 🌐 Turso: Community world (local development)
  • 🌐 MongoDB: Community world (local development)
  • 🌐 Redis: Community world (local development)
  • 🌐 Jazz: Community world (local development)

📋 View full workflow run

@vercel
Copy link
Copy Markdown
Contributor

vercel Bot commented Apr 16, 2026

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
example-nextjs-workflow-turbopack Ready Ready Preview, Comment Apr 16, 2026 4:59pm
example-nextjs-workflow-webpack Ready Ready Preview, Comment Apr 16, 2026 4:59pm
example-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-astro-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-express-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-fastify-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-hono-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-nitro-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-nuxt-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-sveltekit-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workbench-vite-workflow Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workflow-docs Ready Ready Preview, ✅ 1 resolved, Open in v0 Apr 16, 2026 4:59pm
workflow-swc-playground Ready Ready Preview, Comment Apr 16, 2026 4:59pm
workflow-web Ready Ready Preview, Comment Apr 16, 2026 4:59pm

Copy link
Copy Markdown
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

Adds a dedicated “Python SDK” page to the docs Getting Started section and surfaces it prominently in the Getting Started framework grid, including a new Python logo icon export.

Changes:

  • Added docs/content/docs/getting-started/python.mdx with a beta warning and Python concept/code examples.
  • Updated Getting Started index to include a Python SDK card (with a “Beta” badge) and place it first.
  • Added a Python SVG icon export in frameworks.tsx (and reformatted that file’s string quoting).

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File Description
docs/content/docs/getting-started/python.mdx New Python SDK page content with beta callout and concept sections.
docs/content/docs/getting-started/index.mdx Adds the Python SDK card + Beta badge to the Getting Started grid.
docs/app/[lang]/(home)/components/frameworks.tsx Exports a new Python SVG icon for use in docs UI.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment on lines +14 to +18
<Card href="/docs/getting-started/python">
<div className="flex flex-col items-center justify-center gap-2">
<Python className="size-16" />
<span className="font-medium">Python SDK</span>
<Badge variant="secondary">Beta</Badge>
Copy link

Copilot AI Apr 16, 2026

Choose a reason for hiding this comment

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

The Getting Started section appears to be ordered/curated via docs/content/docs/getting-started/meta.json (pages array). That list currently doesn’t include python, so this new page may not show up in the left nav / page ordering even though it’s linked here. Add python to the pages list (and place it first if you want it highlighted first, consistent with this grid).

Copilot uses AI. Check for mistakes.
Comment on lines +1 to +6
---
title: Python SDK
description: Get started with the Vercel Workflow Python SDK for building durable, long-running workflows.
type: guide
summary: Set up the Workflow Python SDK in your Python application.
prerequisites:
Copy link

Copilot AI Apr 16, 2026

Choose a reason for hiding this comment

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

Frontmatter and placement suggest this is a “Getting Started” setup guide (type: guide, summary: Set up...), but the page content is mostly conceptual and doesn’t include the setup steps pattern used by the other getting-started guides (e.g., <Steps> / installation/configuration). Either add the initial setup section(s) or adjust the frontmatter/type/summary so it matches what the page actually provides.

Copilot uses AI. Check for mistakes.
Comment on lines +52 to +79
import random
from app.workflow import wf

@wf.step
async def generate_draft(*, topic: str):
return await ai_generate(prompt=f"Write a blog post about {topic}")

@wf.step
async def summarize_draft(*, draft: str):
summary = await ai_summarize(text=draft)

# Simulate a transient error. The step automatically retries.
if random.random() < 0.3:
raise Exception("Transient AI provider error")

return summary
```

Each step compiles into an isolated route. While the step executes, the workflow suspends without consuming resources. When the step completes, the workflow resumes automatically where it left off.

### Sleep

Sleep pauses a workflow for a specified duration without consuming compute resources. Use it when you need to wait for hours or days before continuing, such as sending a follow-up email or delaying a reward.

```python
from vercel import workflow
from app.workflow import wf

Copy link

Copilot AI Apr 16, 2026

Choose a reason for hiding this comment

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

Several examples import wf from app.workflow / app.workflows.approval, but this is the only doc page using that module path and it’s not established earlier in the guide. For clarity and copy/paste-ability, either show wf = workflow.Workflows() in each snippet, or use a clearly-placeholder module path (e.g., from my_app.workflow import wf) and add a short note that wf is the shared Workflows() instance.

Copilot uses AI. Check for mistakes.
Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
v0 Bot and others added 3 commits April 16, 2026 16:45
Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
Added a new card for the Python getting started guide with a beta badge.

Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
Updated the description for clarity and conciseness.

Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
Co-authored-by: Pranay Prakash <1797812+pranaygp@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants