How to Serve a Local Lab

biosimulant labs serve opens the bundled local lab UI for a runnable lab source tree, .bsilab package, or public registry reference.

Install

pip install biosimulant

No UI extra is required. The local web runtime ships with the default package.

Create a starter lab

biosimulant labs init ./serve-check --name "Serve Check" --force

Start the UI

biosimulant labs serve ./serve-check

The browser opens by default at the root URL, for example http://127.0.0.1:8765/.

For scripts, servers, and CI runners, suppress browser launch:

biosimulant labs serve ./serve-check --no-open --port 8766

What persists

• Model, world, runtime, and wiring edits are saved to lab.yaml.
• Canvas layout is saved to wiring-layout.json.
• Run history is in memory for the active serve process.

Next steps

• Labs Serve UI Reference
• Custom Visualizations
• Write a lab.yaml