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_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.0b5

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.0b5
File	Size	Uploaded
nest_server-3.0.0b5.tar.gz	20.5 kB	Sep 15, 2026	Details

Built distribution (wheel)

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

Total release size: 50.9 kB

Release files / nest_server-3.0.0b5.tar.gz

Download URL	nest_server-3.0.0b5.tar.gz
Size	20.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`eeaa2e9fe6e967bff5f5f099b8d60e3ddb3c3bfaa3d504fc6566b55a4740a5b3`
BLAKE2b-256 checksum How to use checksums	`d0127976522e68f425d12464b7880011989749c572d5a66a1ff10ae194304d34`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nest/nest-server
Publishing commit: github.com/nest/nest-server/tree/41915de4b93274f9cc710864db4b923d6be2b250

Workflow

Publishing configuration: github.com/nest/nest-server/blob/41915de4b93274f9cc710864db4b923d6be2b250/.github/workflows/python-publish.yml
Publishing logs: github.com/nest/nest-server/actions/runs/34958708881/attempts/1

Artifact

Subject: nest_server-3.0.0b5.tar.gz
SHA-256 checksum: eeaa2e9fe6e967bff5f5f099b8d60e3ddb3c3bfaa3d504fc6566b55a4740a5b3 Verifying attestations

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

Download URL	nest_server-3.0.0b5-py3-none-any.whl
Size	30.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2f25dc4835a1afe8e26cfb4538eed6f1390c92d7b740c067fe7c0c838b7a7d98`
BLAKE2b-256 checksum How to use checksums	`d0a4108201e48fdb20cad16cd200d730b1a494202c37a4bc10ac4af03a006c9b`
Upload date	Sep 15, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/nest/nest-server
Publishing commit: github.com/nest/nest-server/tree/41915de4b93274f9cc710864db4b923d6be2b250

Workflow

Publishing configuration: github.com/nest/nest-server/blob/41915de4b93274f9cc710864db4b923d6be2b250/.github/workflows/python-publish.yml
Publishing logs: github.com/nest/nest-server/actions/runs/34958708881/attempts/1

Artifact

Subject: nest_server-3.0.0b5-py3-none-any.whl
SHA-256 checksum: 2f25dc4835a1afe8e26cfb4538eed6f1390c92d7b740c067fe7c0c838b7a7d98 Verifying attestations