CLI tool for pre-compiling eryx WASM runtimes.

Pre-initializes Python and/or pre-compiles WASM to native code, producing artifacts that dramatically speed up sandbox creation.

Examples

# One-time setup for crates.io users (downloads + compiles for your platform)
eryx-precompile setup

# Pre-init + compile for Fly.io (x86-64-v3, no AVX-512)
eryx-precompile compile runtime.wasm -o runtime.cwasm --preinit --stdlib ./python-stdlib --target x86-64-v3

# Pre-init only (output pre-initialized .wasm for later compilation)
eryx-precompile compile runtime.wasm -o runtime-preinit.wasm --preinit --stdlib ./python-stdlib --wasm-only

# AOT compile only (no pre-init, for already pre-initialized .wasm)
eryx-precompile compile runtime-preinit.wasm -o runtime.cwasm --target x86-64-v3

# Pre-init with packages (wheels, tar.gz, or directories)
eryx-precompile compile runtime.wasm -o runtime-numpy.cwasm --preinit --stdlib ./python-stdlib \
  --package numpy-2.2.3-wasi.tar.gz --import numpy

# Pre-init with site-packages directory
eryx-precompile compile runtime.wasm -o runtime.cwasm --preinit --stdlib ./python-stdlib \
  --site-packages ./my-site-packages --import jinja2

# Verify packages work (not just import)
eryx-precompile compile runtime.wasm -o numpy.cwasm --preinit --stdlib ./python-stdlib \
  --package numpy-wasi.tar.gz --import numpy \
  --verify-code "import numpy; print(numpy.array(\[1,2,3\]).sum())"