Try it out!
There's two ways to try out the current state of the wasm port without building anything yourself.
- An instance of the Web REPL hosted at https://keno.github.io/julia-wasm/website/repl.htm
- Using the iodide IDE plugin (see https://alpha.iodide.io/notebooks/225/ to get started).
Both use a pre-built version. Please note that this is an extremely early alpha and many things are likely (and known) to be broken.
Julia on WASM - Setup instructions
This repo contains various experiments for setting up julia on wasm. It's intended for collaboration and issue tracking before things are working sufficiently to switch to the appropriate upstream repo: There's three scripts in this repo:
configure_julia_wasm.shwhich will setup all the directories
build_julia_wasm.shwhich will build two copies of julia (one natively for cross compiling the system image, one for wasm)
rebuild_js.shwhich will rebuild just the wasm parts and dump it into the website/ directory which is a hacked up copy of https://github.com/vtjnash/JuliaWebRepl.jl
To get started
First install the emscripten SDK
# Install emsdk git clone https://github.com/emscripten-core/emsdk.git cd emsdk ./emsdk install emscripten-main-64bit binaryen-main-64bit ./emsdk activate emscripten-main-64bit binaryen-main-64bit
Then build and install upstream LLVM
# Install upstream LLVM git clone https://github.com/llvm/llvm-project mkdir llvm-build cd llvm-build cmake -G Ninja -DLLVM_ENABLE_PROJECTS="clang;lld" -DCMAKE_BUILD_TYPE=Release ../llvm-project/llvm ninja
LLVM_ROOT = '<PATH_TO_LLVM_HERE>/llvm-build/bin'to
Finally, you're ready to build julia for wasm
# Do this once ./configure-julia-wasm.sh # this command may fail at the very end of the build process, that's normal ./build-julia-wasm.sh
This command may fail at the very end with an error like the following:
JULIA build-native/usr/lib/julia/sys-o.a syntax: incomplete: premature end of inputErrorException("") ERROR: LoadError: syntax: incomplete: premature end of input Stacktrace:  top-level scope at /root/julia-wasm/julia/contrib/generate_precompile.jl:7
This is expected (we're using a 32bit linux build, but telling it it's wasm to generate a compatible system image, so things are a bit confused). Afterwards, build the wasm build using:
# Do this after you change something on the wasm side ./rebuild_js.sh
Afterwards you may set up a webserver using:
emrun --no_browser --port 8888 website/repl.htm &
At the moment
Firefox Nightly seems to have the most complete
wasm support and seems to be the fastest, so I'd recommend trying that.
After starting the server above, just navigate to
Enable WASM GC support integration (Firefox Nightly)
Enable WASM Reference Types (Chrome Canary)