NEST Server -- A Python-based API server for the NEST Simulator

This repository contains a REST-based interface to talk to the NEST Simulator.

Quick start

Install NEST Server with pip

pip install nest-server

Start NEST Server

nest-server start

Command options

Entering nest-server without sub-command prints the documentation:

usage: nest-server [-d] [-h HOST] [-o] [-p PORT] [-t TIMEOUT] [-w WORKERS] {log,pid,start,stop,version}

A Python-based API server for NEST Simulator

positional arguments:
  {log,pid,start,stop,version}

options:
  -d, --daemon          daemonize the server process
  -h, --host HOST       use hostname/IP address <HOST> for the server [default: 127.0.0.1]
  -o, --outputs         print NEST outputs to the console
  -p, --port PORT       use port <PORT> for opening the socket [default: 52425]
  -t, --timeout TIMEOUT
                        workers silent for more than this many seconds are killed and restarted [default: 30]
  -w, --workers WORKERS
                        the number of worker processes for handling requests [default: 1]

Default environment variables

# nest-server
NEST_SERVER_DAEMON=false
NEST_SERVER_HOST="127.0.0.1"
NEST_SERVER_LOGFILE="/tmp/nest-server.log"
NEST_SERVER_PIDFILE="/tmp/nest-server.pid"
NEST_SERVER_PORT=52425
NEST_SERVER_STDOUT=false
NEST_SERVER_TIMEOUT=30
NEST_SERVER_WORKERS=1

# main.py
NEST_SERVER_ACCESS_TOKEN=""
NEST_SERVER_DISABLE_AUTH=false
NEST_SERVER_DISABLE_RESTRICTION=false
NEST_SERVER_CORS_ORIGINS="http://localhost:*,http://127.0.0.1:*"
NEST_SERVER_ENABLE_EXEC_CALL=false
NEST_SERVER_MODULES="import nest"

Development mode

We recommend to use virtual environment, e.g. with uv:

Run nest-server in an virtual environment

uv run nest-server start

See more commands in Makefile.

References

Documentation
NEST Simulator via its REST-based interface

Release files for nest-server 3.0.0b4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for nest-server 3.0.0b4
File	Size	Uploaded
nest_server-3.0.0b4.tar.gz	20.7 kB	Sep 14, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for nest-server 3.0.0b4
File	Interpreter	ABI	Platform	Reset
nest_server-3.0.0b4-py3-none-any.whl 30.2 kB Sep 14, 2026	Python 3	none	any	Details

Total release size: 50.8 kB

Release files / nest_server-3.0.0b4.tar.gz

Download URL	nest_server-3.0.0b4.tar.gz
Size	20.7 kB
Tags	Source
SHA-256 checksum How to use checksums	`fedc54837c9d7bd1f0ebd922fb3fa3b4b5f1b3118fa4affefcc90b45730fd5bc`
BLAKE2b-256 checksum How to use checksums	`fa8bd6c0f39bc661343d1ceed620ab48664362ee6053a9b363308ac6f5dc0c58`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.12`

Release files / nest_server-3.0.0b4-py3-none-any.whl

Download URL	nest_server-3.0.0b4-py3-none-any.whl
Size	30.2 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`3cbbd98fba9ea5baf6b88437a0edd4042392816c6fb140a47591034dc73b0c67`
BLAKE2b-256 checksum How to use checksums	`68884623b3fe0f3da4520e12adb42d82044f502da0d9717c381ca9bab57a5e03`
Upload date	Sep 14, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/7.0.0 CPython/3.12.12`