Axiom — Download

To try out Axiom without any permanent changes or installation, run the official Axiom Docker image like so:

$ podman run --rm -it afl5c/axiom axiom

Replace "podman" with "sudo docker" depending on your system. For more options, see the Docker run reference.

This zip file contains Axiom binaries compiled for various platforms:

axiom.exe - Windows 64-bit
- ssleay32.dll and libeay32.dll (OpenSSL) are also included since they are not present by default on Windows.
axiom.mac - MacOS
axiom.linux - Linux 64-bit
axiom.rpi - Raspbian 32-bit

On Mac/Linux systems, the recommended way to install is:

$ unzip axiom.zip
$ cp axiom.[platform] /usr/local/bin/axiom

For example, on MacOS you would type:

$ unzip axiom.zip
$ cp axiom.mac /usr/local/bin/axiom

On Windows the recommended way to install is:

Copy axiom.exe, ssleay32.dll, and libeay32.dll to %LOCALAPPDATA%\Axiom\:
- In Explorer, navigate to %LOCALAPPDATA%.
- Create a folder called "Axiom".
- In another Explorer window, navigate to the zip file.
- Drag the 3 files to the new "Axiom" folder.
Add %LOCALAPPDATA%\Axiom\ to your path:
- In the start menu, search for "environment" and select "Edit the system environment variables".
- In the System Properties dialog, click the button "Environment Variables...".
- In the top pane ("Environment variables for [user]"), select PATH then "Edit..". If PATH is not present, click "New..." and type "PATH" for the variable name.
- Add the value %LOCALAPPDATA%\Axiom\, then click OK in all the dialogs.

Axiom source files should have the extension ".axm" in order to be recognized.

Visual Studio Code — Search the extensions panel for "Axiom" and you should find it:

Screenshot of Axiom extension in Visual Studio Code extension panel

Alternatively, you can visit this page in your browser or download the extension for offline installation here.

Vim — Download axiom-vim.tgz and run:

$ tar xf axiom-vim.tgz
$ sh install.sh

Web — Include axiom.js and put your code in a tag like: <code data-lang="axiom">...</code>

Then somewhere in your Javascript code you can do:

document.querySelectorAll('code[data-lang="axiom"]').forEach((code)=>axiom.highlight(code));

You may also want to include the following CSS:

code {
	font-size: 10pt;
	white-space: pre;
	-moz-tab-size: 4;
	tab-size: 4;
}