Runtime Comparison

tywrap supports five runtime configurations. Choose based on your environment.

Feature Matrix

Feature	Node.js	Bun	Deno (local)	Browser (Pyodide)	HTTP
Python subprocess	✅	✅	✅	❌	❌
Deno Deploy / serverless	❌	❌	❌	✅	✅
Apache Arrow transport	✅	✅	✅	✅	✅
Virtual environment support	✅	✅	✅	❌	Server-side
Process pooling (experimental)	✅	✅	✅	❌	❌
Development hot reload	✅	❌	❌	Manual bridge reload	External
Tested in CI	✅	✅	Mocked	✅	✅

Import Paths

Runtime	Import
Node.js	import { NodeBridge } from 'tywrap/node'
Bun	import { NodeBridge } from 'tywrap/node'
Deno	import { NodeBridge } from 'npm:tywrap'
Browser	import { PyodideBridge } from 'tywrap/pyodide'
HTTP	import { HttpBridge } from 'tywrap/http'

Decision Guide

Do you need subprocess-based Python execution?
├── Yes → Does your environment support subprocess?
│   ├── Node.js or Bun → Use NodeBridge (import from 'tywrap/node' or 'tywrap')
│   ├── Deno (local) → Use NodeBridge with --allow-run=python3
│   └── Deno Deploy / serverless → Continue ↓
└── No (browser, edge, serverless) →
    ├── Can you load ~50MB WebAssembly? → Use PyodideBridge
    └── Need heavy Python libs or can't load WASM → Use HttpBridge

Bridge Reference

Bridge	Export	Guide
NodeBridge	tywrap/node	Node.js · Bun · Deno
PyodideBridge	tywrap/pyodide	Browser
HttpBridge	tywrap/http	HTTP