From the Workflows page choose a template like Bell State or Grover Search. The studio loads the circuit on the canvas and a workflow is created in your active workspace.
2
Tweak the circuit
Drag gates from the Components panel, drop them on a qubit wire, and right-click a gate to edit its parameters. Switch to the Code tab to author supported Qiskit, Cirq, or OpenQASM and sync those edits back into the workflow.
3
Run a simulation
Press Cmd/Ctrl+R or click Run. In the studio this creates a saved run for the active workflow, then executes it through the configured runner path. The Results panel shows measurement counts as the job completes.
4
Inspect in the Observatory
The Observatory tab visualizes histograms, Q-sphere projections, density matrices, and lets you compare runs side-by-side.
5
Target real hardware
Add a provider API key in Settings → API Keys, switch the run mode to Hardware, and select a supported device. Submit-capable adapters validate the workflow, queue the job, and track it until it finishes.
Library
Curated starting points across entanglement, search, transforms, and variational algorithms.
Templates open in the signed-in library. Browse public examples on sample workflows without an account.
Created by a Hadamard on qubit 0 followed by a CNOT(0 → 1). Produces (|00⟩ + |11⟩)/√2, the simplest example of quantum entanglement. Underlies teleportation, superdense coding, and QKD protocols.
Grover's Search
Unstructured search in O(√N) queries versus O(N) classically. Alternates oracle reflection (marks the solution with a phase flip) and the diffusion operator (reflection about the uniform superposition) for roughly π/4·√N iterations.
Shor's Algorithm
Factors an N-bit integer in polynomial time by reducing factoring to order-finding, then solving order-finding with quantum phase estimation on the modular exponentiation operator. Famous for breaking RSA at sufficient qubit counts.
VQE
Variational Quantum Eigensolver: a hybrid quantum-classical loop that prepares a parameterized ansatz, measures the energy expectation value of a Hamiltonian, and updates the parameters classically to minimize energy. Used for molecular ground-state estimation.
QAOA
Quantum Approximate Optimization Algorithm: p alternating layers of a problem unitary e^(-iγH_C) and a mixer e^(-iβH_M) acting on a uniform superposition. A near-term heuristic for combinatorial problems like Max-Cut and MIS.
Providers
Simulation mode uses the configured runner path; in Docker, that is the Python quantum-runner by default. To use submit-capable hardware adapters or vendor-backed devices, add a provider API key.
The provider catalog covers IBM Quantum, Google Quantum AI, IonQ, Rigetti, Microsoft Azure Quantum, Amazon Braket, and additional device catalogs. Some integrations are credential/device-test only; unsupported direct submissions return validation or unsupported-provider errors. Keys are encrypted at rest and only used server-side.
Provider keys can be tested from Settings. Hardware health and device lists are fetched through the provider/device API routes, while the sidecar poller reconciles already-submitted hardware jobs.
Grouped by context. On Windows and Linux, use Ctrl in place of Cmd.
Workflow
Common workflow actions. Browser/editable fields may reserve shortcuts while focused.
Save workflowCmd+S
Save workflow (Windows / Linux)Ctrl+S
New workflowCmd+N
Close workflowEsc
Run
Execute the active circuit against the selected backend.
Run simulationCmd+R
Run simulation (Windows / Linux)Ctrl+R
Choose dry-run or hardwareRun+Menu
Navigation
Two-key sequences to jump between top-level pages.
Go to Studiog+s
Go to Workflowsg+w
Go to Runsg+r
Studio
Canvas, drag-and-drop, and gate editing.
Drag gate onto canvasDrag from Components
Open gate context menuRight-click gate
Undo last editCmd+Z
RedoCmd+
Command Palette
Search and execute any action from anywhere.
Open command paletteCmd+K
Cycle results↑+↓
Run highlighted resultEnter
Close paletteEsc
Command palette
Press Cmd + K to search commands, workflows, and pages.
Documentation
Reference for designing circuits, running them, and using the REST API.
Overview
QFlow Studio builds, simulates, and executes quantum circuits through local simulators and supported provider adapters. Author visually on the canvas or write supported Qiskit, Cirq, or OpenQASM; saved code changes can be parsed back into the workflow model.
Workflows are saved per workspace and versioned on publish. Pressing Run creates a saved run for the active workflow; simulation and submit-capable hardware adapters report results back into the Observatory with counts, statevectors, and timing where available.
The platform has three primitives: workflows (the circuit definition), runs (one execution on a backend), and providers (the cloud endpoints).
Building circuits
Drag gates from the Components panel onto qubit wires; drop targets snap to time slots. Right-click a gate for parameter editing, conjugate, repeat, and decompose. The Code editor parses supported Qiskit, Cirq, and QASM back into the canvas model when you save or sync code edits.
Press Cmd/Ctrl+R or click Run. Runs are saved per workflow and can target simulation, dry-run validation, or hardware mode from the Run menu. Shots and noise model are captured with each run so Observatory and history views can replay the exact request.
API reference
Core workflow, run, provider, learning, and admin actions are exposed through REST routes. Browser sessions use the app session cookie; cron endpoints useCRON_SECRET bearer headers.
Workflows
Method
Endpoint
Description
GET
/api/workflows
List the current user's workflows (filterable by workspace).
POST
/api/workflows
Create a new workflow with circuit JSON and metadata.
GET
/api/workflows/[id]
Fetch a single workflow by id.
PUT
/api/workflows/[id]
Update a workflow's name, description, circuit, or tags.
Workspaces
Method
Endpoint
Description
GET
/api/workspaces
List the user's workspaces.
POST
/api/workspaces
Create a new workspace.
GET
/api/workspaces/active
Get the user's active workspace.
PATCH
/api/workspaces/[id]
Update workspace name, description, color, or icon.
Runs
Method
Endpoint
Description
GET
/api/runs
List recent runs, optionally filtered by workflow.
POST
/api/runs
Queue a new circuit run (simulation, dry-run, or hardware).
GET
/api/runs/[id]
Fetch a run's status, counts, and metadata.
DELETE
/api/runs/[id]
Cancel a queued or running job.
Providers & Keys
Method
Endpoint
Description
GET
/api/api-keys
List the user's stored provider API keys (masked).