HUB
Sign inSign up

clfoundation/miricl

By clfoundation

•Updated 8 days ago

Image
0

366

clfoundation/miricl repository overview

⁠Supported Tags

⁠Simple Tags

  • 2026.11.09 2026.11.09-trixie 2026.11.09-trixie-amd64 2026.11.09-trixie-arm64 2026.11.09-trixie-slim 2026.11.09-trixie-slim-amd64 2026.11.09-trixie-slim-arm64

⁠Shared Tags

  • latest
    • 2026.11.09

⁠Quick Reference

miricl Home Page
https://github.com/ak-coram/miricl⁠

Where to file Docker image related issues
https://gitlab.common-lisp.net/cl-docker-images/miricl⁠

Where to file issues for miricl itself
https://github.com/ak-coram/miricl/issues⁠

Maintained by
CL Docker Images Project⁠

Supported platforms
linux/amd64 and linux/arm64 for every tag

⁠What is miricl?

miricl, by Ákos Kiss, is Common Lisp on WebAssembly: an interpreter, a self-hosted native Wasm compiler and a whole-program optimizer, for browsers, Node.js and Wasmtime, with ASDF as an optional library.

miricl publishes no releases. A tag here is the date of the commit of miricl's main branch that the image was built from; the image names that commit in MIRICL_COMMIT.

⁠How to use this image

⁠Start a REPL

\$ docker run -it --rm clfoundation/miricl:latest

:quit leaves it.

⁠Run a Common Lisp script

The miricl command reads forms on standard input; it takes no file argument. Lisp sees the current directory as its /, so a script and the files it loads are mounted and made the working directory:

\$ docker run -i --rm -v "\$PWD":/usr/src/app -w /usr/src/app clfoundation/miricl:latest < your-script.lisp

Three things differ from the other Common Lisp images:

  • Lisp sees one directory of the container as its /: the working directory, or the one --directory names. With --directory /, or when the working directory is /, that is the whole container.
  • What Lisp writes stays in memory and is gone when it exits. Only --bundle and --optimize write their output to disk.
  • The REPL exits with status 0 whatever happened. An error at top level prints Error: and a backtrace, and the next form is read.

⁠ASDF

ASDF is a separate file, /opt/miricl/miricl-asdf.wasm. Where Lisp sees the whole container:

(load "/opt/miricl/miricl-asdf.wasm")
(asdf:load-asd #P"/usr/src/app/app.asd")
(asdf:load-system "app")

Where it sees one directory, link or copy the file into it first.

⁠Build an application for the browser

--bundle compiles an ASDF system and its dependencies into one loadable file. It looks for miricl-asdf.wasm in the directory it serves:

\$ docker run --rm -v "\$PWD":/usr/src/app -w /usr/src/app clfoundation/miricl:latest \
    sh -c 'cp /opt/miricl/miricl-asdf.wasm . && miricl --bundle app --output dist/app.wasm'

A web page then needs three static files, from any web server: miricl.js and miricl-precompiled.wasm (or the smaller miricl.wasm) out of /opt/miricl, and the bundle. See Usage⁠ in miricl's README for the page's script.

⁠What's in the image?

The five files of miricl's distribution, built from source, in /opt/miricl, with miricl's license:

  • miricl.js, the adapter for browsers and Node
  • miricl.wasm, the interpreter and compiler
  • miricl-precompiled.wasm, the same with the native compiler ready at startup
  • miricl-repl.wasm, the terminal command for Wasmtime
  • miricl-asdf.wasm, ASDF and UIOP

miricl, on the PATH, runs miricl.js under Node with miricl-precompiled.wasm, and passes its arguments on (miricl --help lists them). Set MIRICL_IMAGE to choose another image: /opt/miricl/miricl.wasm evaluates with the interpreter.

⁠Image Variants

⁠clfoundation/miricl:<version>

This is the defacto image. It is based on Node's full Debian image, which carries the common build tools.

⁠clfoundation/miricl:<version>-slim

This image is based on Node's slim Debian image and carries only what is needed to run miricl.

⁠Building and Contributing

For information on building these images and contributing, please see the repository at https://gitlab.common-lisp.net/cl-docker-images/miricl⁠.

⁠License

miricl itself is licensed under the GNU Lesser General Public License, version 3 or later; its text is in the image at /opt/miricl/LICENSE and its source at the commit MIRICL_COMMIT names. The Dockerfiles and build infrastructure are licensed under the BSD 2-Clause License. See the LICENSE file in the repository for details.

Tag summary

Content type

Image

Digest

sha256:c1e766946…

Size

425.4 MB

Last updated

8 days ago

docker pull clfoundation/miricl