Skip to content

Open source · xarray · Qanary · QCoDeS · Quantify

Live plotting for quantum measurements

Browse, plot and annotate measurement data on disk, or while it is still being acquired.

Download Qimchi

v0.7.1Windows · macOS · Linux

All downloads →

Formats

Built on xarray: anything that opens as, or converts to, an xarray.Dataset can be plotted natively, and other formats need only a short custom loader. Files are read where they are on the disk.

Go live from your measurement loop

Measure with Qanary and each run will appear in Qimchi automatically. Code that returns an xarray.Dataset can be published with qimchi-connect, which has ready-made providers for QCoDeS and Quantify.

from qanary import measure
from qanary.sweep import Sweep

# The run appears in Qimchi's Live panel automatically.
measure.run(
    [
      Sweep(flux, -1e-3, 1e-3, num=201),
      Sweep(frequency, 7.25e9, 7.27e9, num=401),
    ],
    dependents=[s21],
    wafer_id="W12",
    device_type="resonator",
    sample_name="chip-Q3",
    experiment_name="resonator_flux",
    station=station,
)

  1. 1.Your measurement

    Qanary, QCoDeS, Quantify, or any code that builds an xarray.Dataset.

  2. 2.qimchi-connect

    Built into Qanary. Serves snapshots of the dataset while the sweep runs.

  3. 3.Qimchi

    Lists the run under Live and redraws it as data arrives.

  • pip install qanary, or pip install qimchi-connect for other code; Python 3.13+
  • New runs go straight into the Basket and are plotted
  • Plots refresh every 0.1 to 1 s; filters stay applied
Qanary documentationqimchi-connect on GitLab

Features

Overview

Browse measurements in the Explorer, open datasets in the Basket and choose plot type and axes in the Composer. Plot, filter and export from the Viewer, all in one window.

Download

Free and open source (AGPL-3.0). Runs locally.

v0.7.1Released 17 October 2026

Windows 10, 1809+, 64-bit. Per-user install, no admin rights needed.

Download .exe for Windows

Installation

  1. 1

    Run the installer.

  2. 2

    SmartScreen flags the unsigned installer: choose More info → Run anyway.

  3. 3

    Qimchi checks for updates and asks before installing from then on.

ChangelogGitLabReleases

Frequently Asked Questions

Is Qimchi open source?

Yes, under the AGPL-3.0-or-later. The source is on GitLab.

Does my data leave my computer?

No. Qimchi reads your files where they are and runs entirely on your machine. There is no telemetry or automatic data collection. The only request it makes on its own is checking GitLab for a new release, which you can turn off in Settings.

Why does Windows or macOS warn me when I install it?

The installers are not code-signed (Windows) or notarized (macOS) yet. On Windows choose More info, then Run anyway; on macOS, open it once from System Settings → Privacy & Security → Open Anyway. You only do this once per version.

Does it work offline?

Yes. Browsing, plotting, filters and notes need no network. The first PNG/SVG export downloads a copy of Chrome if none is installed; after that, export works offline too.

My data is in another format. Can Qimchi read it?

Anything that opens as, or converts to, an xarray Dataset can be plotted. For other formats, a custom loader of a few lines is enough.

How do I plot a measurement while it is running?

If you measure with Qanary, each run appears in Qimchi automatically. Otherwise, publish it from your measurement loop with qimchi-connect. It works with QCoDeS, Quantify, or any code that builds an xarray Dataset. Qimchi adds the run to the Basket and redraws as data arrives.

Can the whole lab share one installation?

Partly. You can run the Docker image on a server next to the data and open it in a browser from any computer. Qimchi has no user accounts yet, though, so everyone using it shares the same settings, tags, hearts and notes. That suits a small group working together, or one person at a time. For your own computer, the desktop app is simpler.

How do I report a bug?

Open an issue on GitLab. Visit Settings → Developer → Save logs to collect the logs to attach.

How do I request new features?

Open an issue on GitLab describing what you would like Qimchi to do and why. A screenshot or a small example dataset helps. If someone has already asked for it, give their issue a thumbs-up instead.

Cite Qimchi

If Qimchi helped with your work, please cite it.

@misc{qimchi,
  author       = {Shivottam, Jyotirmaya and Anupam, Spandan},
  title        = {Qimchi: Live plotting for quantum measurements},
  year         = {2026},
  note         = {Version 0.7.1, software},
  howpublished = {GitLab},
  url          = {https://gitlab.com/squad-lab/qimchi}
}