/kernel-pyodide

CPython-in-WASM kernel (Pyodide) — run real Python code from agents on Node, Bun, and CF Workers.

Part of wasmagent — a TypeScript + WASM agent runtime.

Install

npm install /kernel-pyodide /core pyodide

Usage

import { PyodideKernel } from "/kernel-pyodide";

const kernel = new PyodideKernel();
const result = await kernel.run(`import math; print(math.gcd(2024, 56))`);
console.log(result.logs); // ["8"]

⚠️ Memory budget on edge runtimes — Pyodide's WASM image and Python heap together are ~50–80 MB resident. Cloudflare Workers' free tier (~128 MB) leaves only thin headroom for user code; for memory-heavy workloads use kernel-wasmtime or kernel-remote microVMs.

See the kernel decision tree.

License

Apache-2.0 — © wasmagent contributors