Skip to content

Running the examples

John O'Sullivan edited this page Oct 28, 2026 · 12 revisions

Bear in mind that C++ processes must be launched with NoDOM env vars set. Which means it must be run in a command prompt where you've executed the ndroot,ndinit,ndide sequence. Python example server processes are less demanding and can be launched without any specific env var requirements.

add_server

breadboard: to run the Python server for the breadboard client on port 8890...

cd %ND_HOME%\src\py
..\..\venv\scripts\python add_server.py --port=8890

And to run the breadboard client itself...

cd %ND_HOME%
src\cpp\release\breadboard add %ND_HOME%\cfg

wasm: to run add_server with the wasm client we start the server on port 443...

cd %ND_HOME%\src\py
..\..\venv\scripts\python add_server.py --port=443

Then start Chrome and navigate to https://localhost/add.html. You will have to dismiss warnings about an unknown cert. And you might want to do a ctrl-sh-I to bring up the Chrome debugger so you can read the console log.

fin_server

breadboard: you'll need two Python servers for the breadboard client on port 8890. First, the pq_server which defaults to port 443 per DuckDB requirements...

cd %ND_HOME%\src\py
..\..\venv\scripts\python pq_server.py

And then, in a second DOS box, to run the fin_server itself...

cd %ND_HOME%\src\py
..\..\venv\scripts\python fin_server.py --port=8890 --emu

And then to run the breadboard client itself...

cd %ND_HOME%
src\cpp\release\breadboard fin %ND_HOME%\cfg

wasm: to run fin_server with the wasm client we start the server on port 443...

cd %ND_HOME%\src\py
..\..\venv\scripts\python fin_server.py --port=443 --emu

Then start Chrome and navigate to https://localhost/fin.html. NB you do not need a separate pq_server instance on 443 when fin_server itself is on port 443.

qed_server

breadboard: to run the Python qed_server for the breadboard client on port 8890...

cd %ND_HOME%\src\py
..\..\venv\scripts\python qed_server.py --port=8890

And to run the breadboard client itself...

cd %ND_HOME%
src\cpp\release\breadboard qed %ND_HOME%\cfg

wasm: to run add_server with the wasm client we start the server on port 443...

cd %ND_HOME%\src\py
..\..\venv\scripts\python qed_server.py --port=443

Then start Chrome and navigate to https://localhost/qed.html.

Clone this wiki locally