Skip to main content

Quick start

WLJS Notebook requires wolframscript (see Freeware Wolfram Engine or Wolfram Kernel) installed on your PC/Mac. If not, WLJS application will redirect you to the official download page

All algorithms, functions, and other components of the Wolfram Language provided by the Wolfram Engine are the intellectual property of Wolfram Research, Inc.

Overview 🚀 Demo 📺

note

WLJS Notebook is a freeware software, which is based on Wolfram Engine.

You do not need to have Mathematica installed to run WLJS Notebook. No subscription model, only one-time registration at wolfram.com is needed for a personal use. Please check the license agreement.

If you are new to Wolfram Language, please, check the corresponding page.

There are two ways you can choose from

Desktop application

Notebook interface is shipped as an Electron application, which is cross-platform and has most benefits of a native desktop app. This is the easiest way

Releases

It comes with a launcher, that takes care about all updates, files extension association and etc. Also see releases page for more portable installation bundles (no docs).

Cli

It registers wljs in the system binaries. Then any user can open a folder in WLJS Notebook by typing a command in the terminal

wljs .

Server application

Since this is a web-based application, you can also run on a server. User interface is reachable from any modern browser. Clone a master branch and run wolframscript

git clone https://github.com/JerryI/wolfram-js-frontend
cd wolfram-js-frontend
wolframscript -f Scripts/start.wls

It will take some time to download all core plugins, after that you can start using it by opening your browser

...
Open http://127.0.0.1:20560 in your browser

To start server on a specific hostname

wolframscript -f Scripts/start.wls host 0.0.0.0 http 8080 ws 8081 ws2 8082 docs 8085

that will open an HTTP server on 8080 port with 8081, 8082 used for realtime communication and docs pages at 8085

Extra arguments

  • set the home folder (overrides the default settings)
wolframscript -f Scripts/start.wls folder "Demos"
  • disable autolaunch of the evaluation kernel
wolframscript -f Scripts/start.wls noautolaunch True

A side note for servers with no desktop interface

You might need to install the following (for Image and some other graphics to work properly) libraries.

Docker container

contributed by @yloose

Please follow the instructions

Sponsorship

To help maintain this open-source project ❤️

Any amount (one-time or monthly) is appreciated, and your profile will be permanently displayed on this page. Thank you for helping us!

Showcase

Blog posts

🔗 Link Pages of real-life problems solved using WLJS Notebook and published as interactive notebooks running in your browser. Try it out

WLJS Notebook Demonstration Project

🔗 Link Notebooks posted as static web pages showcase various examples that demonstrate how to use the Wolfram Language and the dynamic features of our frontend.

Media

Publications 📢