Skip to content
/ Woxi Public

Wolfram Language / Mathematica reimplementation in Rust (Wolfram oxidized)

Notifications You must be signed in to change notification settings

ad-si/Woxi

Repository files navigation

Wordmark of Woxi

Woxi

A Rust-based interpreter for a subset of the Wolfram Language.

Features

The initial focus is to implement a subset of the Wolfram Language so that it can be used for CLI scripting and Jupyter notebooks. For example:

#!/usr/bin/env woxi

(* Print 5 random integers between 1 and 6 *)
Print[RandomInteger[{1, 6}, 5]]

Screenshot of Jupyter Notebook

Check out the CLI tests directory to see all currently supported commands and their expected output. All tests must pass with Woxi and WolframScript.

Check out the functions.csv file for a list of all Wolfram Language functions and their implementation status.

Woxi runs faster than WolframScript as there is no overhead of starting a kernel and verifying its license.

Installation

To use Woxi, you need to have Rust's cargo installed on your system.

cargo install woxi

From Source

If you want to build Woxi from source, you need to have Rust installed. You can get it from rust-lang.org.

Clone the repository, build the project, and install it:

git clone https://github.com/ad-si/Woxi
cd Woxi
make install

Usage

You can use the interpreter directly from the command line:

woxi eval "1 + 2"
# 3
woxi eval 'StringJoin["Hello", " ", "World!"]'
# Hello World!

Or you can run a script:

woxi run tests/cli/hello_world.wls

Jupyter Notebook

You can also use Woxi in Jupyter notebooks. Install the kernel with:

woxi install-kernel

Then start the Jupyter server:

cd examples && jupyter lab

CLI Comparison With WolframScript

Woxi WolframScript
woxi eval "1 + 2" wolframscript -code "1 + 2"
woxi run script.wls wolframscript script.wls
woxi repl wolframscript

Contributing

Contributions are very welcome! Please feel free to submit a Pull Request.

Testing

To run the test suite:

make test

Related