Skip to main content
This page tracks all local benchmark suites shipped in benchmarks/:
  • bench (cold container spawn benchmark)
  • bench:pool (warm-pool benchmark)
  • bench:detailed (phase-level breakdown)
  • bench:tti (ComputeSDK-style TTI, cold)
  • bench:tti:pool (ComputeSDK-style TTI, warm pool)

Latest run snapshot

Run date: 2026-02-19 Environment capture time (UTC): 2026-02-19T09:28:47Z

Benchmark environment

These benchmarks are host-sensitive. Re-run on your target machine before using values as SLO or regression gates.

bun run bench (cold spawn benchmark)

bun run bench:pool (warm pool benchmark)

bun run bench:detailed (phase breakdown, cold path)

ComputeSDK-style TTI benchmark

This suite is aligned to the ComputeSDK benchmark README, where TTI is measured as create/init + first command execution.

bun run bench:tti (cold, median TTI)

bun run bench:tti:pool (warm pool, median TTI)

Comparison context vs ComputeSDK benchmarks

ComputeSDK’s README reports direct-mode provider medians (last run shown there: 2026-02-19T00:30:31.834Z):
This is directional context, not a strict apples-to-apples ranking. Environment, provider architecture, geography, and sandbox lifecycle semantics differ.

Reproduce locally (all suites)

Run benchmarks on GitHub Actions

You can also run benchmarks on a GitHub-hosted runner by manually triggering production-test.yml.
  • workflow: Production Tests (Manual)
  • runner: ubuntu-latest
  • input: set runBenchmarks=true
  • behavior: benchmarks run after production tests pass (the workflow executes bun run bench:cli)

FAQ

They represent steady-state latency after initial startup, which is the dominant user experience in long-lived services.
Use bench:detailed to find phase bottlenecks, then validate impact with bench:pool and bench:tti:pool.
Cold runs include one-time lifecycle costs that warm pools avoid (container creation/start and first-path setup).
Treat it as directional only. Use the same region, host class, and iteration settings before drawing hard conclusions.

Troubleshooting quick checks

  • benchmark command fails on first run: rerun sequentially, not in parallel
  • unexpectedly high warm TTI: verify pool defaults in isol8.config.json and container host load
  • noisy results: increase iterations and run with minimal background system activity

Performance tuning

Pool and concurrency tuning guidance for better latency.

Server overview

How isol8 serve applies pooling defaults for remote execution.

Configuration reference

Set poolStrategy, poolSize, and other execution defaults.

Architecture

Understand execution path and pool lifecycle internals.