search

JerryI / wolfram-js-frontend

Dynamic Notebook Environment for Wolfram Language written in Javascript
https://jerryi.github.io/wljs-docs/
GNU General Public License v3.0
317 stars 15 forks source link
computational-science gui interactive-visualizations javascript-project mathematica notebook plotting wolfram-language

readme

Dynamic Notebook Environment for Wolfram Language

Preview

Made by the cooperation of physicists and programmers. Driven by solving real-life cases in science ⚗️, math 🧮 and teaching 📚

written with love using freeware Wolfram Engine, JavaScript and WLX

WLJS Notebook Demonstration Project 🎉 A collection of various notebooks showcasing examples of how to use the Wolfram Language and the dynamic features of our frontend

Documentation & Tutorials 📔

Wolfram Language Introduction 🐺

Freeware implementation of Wolfram Language

Telegram support chat 💬

Recommended Wolfram Engine: 13.3 or higher

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

Special thanks to our co-developer @KirillBelovTest (Wolfram Language Web Stack developer)

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 runnning 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.

Contributing

See here

Media

Publications 📢

Highlights

Not a typical Jupyter-like notebook environment 🧨

It supports dynamics, GUI building blocks, and powerful Mathematica syntax out of the box.

alt text

alt text

alt text

No more static graphics! Each primitive of Graphics/Graphics3D was recreated from scratch using d3.js and THREE.js libraries. Most native plotting functions of Mathematica are supported.

Command Palette and GUI-in-Code Emulation 🎨

Native Math Input in the Code Editor 🧮

Write beautiful equations between lines of normal Wolfram Language expressions.

Mathinput-ezgif com-optipng

There is no need to lift your fingers from the keyboard 🎹

Mathinput-ezgif com-optipng

Shortcuts

Or use toolboxes for complex structures such as integrals, sum, Greek letters

Inline Dynamic Tool for Tuning 2D/3D Positions

ezgif com-optipng

Export to HTML / Markdown / MDX 🗜️

An entire notebook can be exported to a standalone .html file keeping all data inside. No internet dependency, no additional software is required for viewing a notebook

HTML-ezgif com-optipng

No more static pictures with code

Even if you embed it to your blog page

Deploy as a web-page

still experimental feature

See some interactive examples from our blog page

Later, once opened using WLJS Notebook application, it is unpacked back to a normal editable format.

AI Assistant 🤖

We deeply integrated ChatGPT, so that AI can have a read/write acccess to your notebook

AAI

Data-Driven Slides 🛝

Make a presentation right from the notebook.

slides

Real-Time Interactivity ⏱️

Follows the mouse pointer and performs complex calculations

You do not need to target 60FPS, Javascript will interpolate the transitions smoothly

A toy-like fluid simulation is also possible

Many More

Offline documentation 🩺

WLJS Notebook runs locally and belongs to you (no cloud-based stuff involved). No internet connection is needed.

Sponsors (one-time or monthly) ☺️

Installation 🛠️

The freeware Wolfram Engine is required (Version 13.3 is preferable). Activation can be done later using WLJS Notebook App.

On macOS, if you have Homebrew installed, you can install it through Homebrew Cask:

brew install --cask wolfram-engine

a side note for OSX/Linux users If you face any issues, try to install avahi daemon and libuv.

Desktop App ✨

Download from the releases section.

CLI

You can start it from the terminal like VSCode by typing

wljs .

Notes for Windows users

Works good

Note for Debian users

Works good. You might need to install libuv dependency

Note for Ubuntu users

There will be a problem with starting related to a new AppArmor issue om Ubuntu 24.04. A temporal fix will be to lift the restrictions globally

sudo sysctl -w kernel.apparmor_restrict_unprivileged_userns=0

You can always bypass this complexity by using [console application instead](#Standalone Server) (see Standalone Server or Docker).

Note for MacOS users

Works good.

Again, if you have Homebrew installed, you can install this app using:

brew install --cask wljs-notebook

Docker Container

contributed by @yloose

See here

Standalone Server

Desktop application is just a wrapper with a built-in Chromium browser, context menu bindings and file associations. WLJS Notebook itself is a web-based application and can run using just wolframscript with no external services or any other programs.

Clone this repository and run:

wolframscript -f Scripts/start.wls

or 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

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.

Shortcuts 🎬

working in both: browser and desktop application

UI

Cells

Package System

WLJS Notebook fully supports the native Wolfram Language paclets/packages system and cna be installed from the command palette (paste there a Github url to a package). It means most packages will work like in Mathematica with some limitations on dynamics (DynamicModule, Opener and etc).

Technology Stack

Wolfram Language, WLX, HTML, CSS, JavaScript, C

Frameworks & Libraries

Inspired By

License

GNU GPLv3