Try it out!

There's three ways to try out the current state of the wasm port without building anything yourself. 1. An instance of the Web REPL hosted at https://keno.github.io/julia-wasm/website/repl.htm 2. Using a modified version of the Pluto IDE, available at https://pluto-wasm-backend.netlify.app/editor.html 3. 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.sh

build_julia_wasm.sh

rebuild_js.sh

To get started

Pre-conditions

1. nodejs

2. gcc-multilib

   and

   g++-multilib

Emscripten SDK

First install the emscripten SDK ```sh

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 ```

Upstream LLVM

Then build and install upstream LLVM ```sh

Install upstream LLVM

git clone https://github.com/llvm/llvm-project mkdir llvm-build cd llvm-build cmake -G Ninja -DLLVMENABLEPROJECTS="clang;lld" -DCMAKEBUILDTYPE=Release ../llvm-project/llvm ninja ```

Setup environment

1. Add

   LLVM_ROOT = '/llvm-build/bin'

   to

   $HOME/.emscripten

2. Add

   llvm-build/bin

   to

   $PATH

Bootstrapped build

Finally, you're ready to build julia for wasm ```sh

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:
 [1] top-level scope at /root/julia-wasm/julia/contrib/generate_precompile.jl:7

 # Do this after you change something on the wasm side
 ./rebuild_js.sh

emrun --no_browser --port 8888 website/repl.htm &

Firefox Nightly

localhost:8888/repl.htm

Enable WASM GC support integration (Firefox Nightly)

In

about:config

javascript.options.wasm_gc

Enable WASM Reference Types (Chrome Canary)

google-chrome-unstable  --jsflags="--experimental-wasm-anyref"