arnoudbuzing / wolfram-server Goto Github PK

Simple JSON based Wolfram Language expression evaluation server

Go 13.69% Python 2.84% JavaScript 10.22% HTML 59.07% Ruby 6.87% Julia 3.09% R 4.22%

wolfram-language wolfram-mathematica json wolfram-engine language-server-protocol language-api language-apis golang javascript python

wolfram-server's Introduction

wolfram-server

JSON based Wolfram Language expression evaluation server

Usage notes

The server accepts HTTP POST requests, where the body data consists of Wolfram Language code. It takes this code, as a string, and evaluates it. Finally it converts the evaluated expression to ExpressionJSON and sends this JSON expression back to the client making the request.

Starting the Wolfram Language server

General usage:

wolframserver.wls [port]

If port is omitted a random (available) port is automatically selected.

Example, launch the server on port 5858:

wolframserver.wls 5858

Connecting to the server

Examples of language specific clients are in the clients directory.

Using curl

> curl -d "DateString[]" -X POST http://127.0.0.1:5858
"'Fri 26 Jul 2019 14:33:28'"

Using wget

> wget -qO- --post-data="DateString[]" http://127.0.0.1:5858
"'Fri 26 Jul 2019 14:25:56'"

Using Wolfram Language

> wolfram-client.wls "DateString[]"
"'Fri 26 Jul 2019 14:45:41'"

Using Go

Directly:

> go run go-client.go "DateString[]"
URL:> http://127.0.0.1:5858
response Status: 200 OK
response Headers: map[Content-Type:[application/json]]
response Body: "'Fri 26 Jul 2019 14:32:25'"

With compilation:

> go build go-client.go
> go-client.exe "DateString[]"
URL:> http://127.0.0.1:5858
response Status: 200 OK
response Headers: map[Content-Type:[application/json]]
response Body: "'Fri 26 Jul 2019 14:31:41'"

Using Python

> python-client.py "DateString[]"
result: "'Fri 26 Jul 2019 14:30:43'"

Using R

library(httr)
r <- POST('http://127.0.0.1:5858', body = 'DateString[]' )
print(content(r))

Using NodeJS

> node node-client.js "DateString[]"
statusCode: 200
"'Fri 26 Jul 2019 14:31:09'"

Using Windows PowerShell

> (Invoke-WebRequest -Method POST -Body "DateString[]" -Uri http://127.0.0.1:5858).Content
"'Fri 26 Jul 2019 14:36:47'"

wolfram-server's People

Contributors

Stargazers

Watchers

Forkers

rohitn dbxdev perdalum classicvalues standardgalactic

wolfram-server's Issues

Request for clarification

Hi there, I was able to make use of this script for a very specific requirement of communicating from nodejs. Very well written piece of code and useful as well. Many thanks.
An expanded requirement for our specific scenario is to have this wolfram server as a state machine wherein for example the output of the first command in the sequence given from nodejs is available for processing the second command in the sequence. Is this possible to be implemented in the server?

Parallelizing multiple servers

Hello,

very useful project, thanks.

So I have a question, I am not sure how to contact you, and maybe others could be interested so I'll write this here.

I have a use case where I run this Wolfram server code on my local machine inside a notebook, and it receives requests from a Python script, it works fine, this is great. This is part of a bigger pipeline however, and the calculation I make inside my Wolfram notebook is a big bottleneck in terms of execution time.

For this reason, I'm trying to run multiple server instances simultaneously, to "load balance" the incoming requests flux. The idea is to do this by duplicating the notebook and changing the port I listen to on each notebook.

I can currently achieve this by starting each version of the notebook on a separate instance of the Mathematica software, but by doing that, I have to use several Mathematica licenses, which severely limits the number of servers I can launch (I don't want to use too big of a proportion of the license pool available in my company).

When I'm trying to do this by using a single Mathematica instance, by just opening all the notebooks on this instance and running them, only the first one I start is effective and actually listens on the requested port, the following ones don't.

My question then is: do you see an effective way of running multiple instance of this Wolfram server code without using multiple Mathematica licenses? I'm not trying to circumvent the licensing system, I just feel like it should be possible and I am doing it wrong.

Many thanks.