QuantumSavory Studio is a browser application for designing and simulating quantum
networks with QuantumSavory.
Use the hosted application at studio.quantumsavory.org.
This QuantumSavoryStudio repository contains the Julia/Genie backend, the Vue
interface, and their private support API.
The CI toolchains use Julia 1.12, Node.js 24, and npm.
git clone https://github.com/QuantumSavory/QuantumSavoryStudio.git
cd QuantumSavoryStudio
julia --project=. -e 'using Pkg; Pkg.instantiate()'
./bin/serverOpen http://localhost:8000. The launcher installs the locked frontend dependencies and builds the interface before starting Genie.
Projects are stored in the browser. Project files use the current
schemaVersion: 2 format. The HTTP routes support the bundled interface and are not a
separate public API.
The optional MCP sidecar lets an agent collaborate with the project open in the browser. It is disabled by default and listens only on loopback.
WEBQUANTUMSAVORY_ENABLE_MCP=true ./bin/serverOpen the MCP Tools tab and select Initialize MCP. The default endpoint is
http://127.0.0.1:8001/mcp; choose another local port with
WEBQUANTUMSAVORY_MCP_PORT. The browser owns the visible project and must remain
connected for edits and lifecycle actions.
Custom functions, symbolic values, numeric expressions, and evaluation previews can execute Julia in the backend process. The source filter is not a security sandbox. Enable these features only when every user and project source is trusted.
WEBQUANTUMSAVORY_ENABLE_UNSAFE_EVALUATION accepts true or false. When unset,
evaluation is enabled in Genie dev and test environments and disabled elsewhere.
Run the checked-in scripts from the repository root:
./ci/backend-unit.sh
./ci/mcp-unit.sh
./ci/frontend-build.sh
./ci/backend-integration.sh
./ci/browser.shThe integration scripts manage their own test servers. Frontend-only commands are in
gui/README.md; Julia suite details are in
test/README.md.
QuantumSavory Studio is available under the MIT License.