QML Observer

An open-source observability and diagnostic framework for variational quantum machine learning (QML) training. QML Observer watches training runs in real time, detects pathologies such as probable barren plateaus, stagnation, and noise-dominated optimization, and can log, warn, pause, or stop training before expensive quantum computation is wasted.

Status: v0.7.0 — public beta. Core schemas, monitoring engine, detectors, diagnosis engine, actions (including a real PauseAction), both the PennyLane and Qiskit adapters, JSONL logging, run summaries, compute-saved estimation, the CLI, the calibration benchmark suite, webhook alerting (including a Slack-compatible formatter, alert deduplication/cooldowns, evidence redaction, and a webhook-URL SSRF safeguard), an optional read-only dashboard (qml-observer[dashboard]: live loss/gradient charts, a diagnosis panel, compute-usage panel, run history, and data export), opt-in research-grade diagnostics (qml_observer.advanced: QFIM estimation/conditioning, parameter-redundancy detection, Hessian-vector products, loss-landscape sampling, and qubit/depth gradient-variance scaling analysis — see docs/research/geometry.md), an opt-in recovery engine (qml_observer.recovery: ranked recovery strategies — reinitialization, learning-rate/shot-budget adjustment, ansatz-depth reduction, optimizer switching, natural gradient — plus recovery evaluation and monitor resume after a pause; see docs/architecture/recovery.md), and broader ecosystem support (PyTorch/JAX hybrid-workflow adapters, a generic autograd adapter, MLflow/W&B experiment-tracker integrations, a third-party detector plugin API, and local run comparison/experiment management — see docs/development/plugin_api.md and docs/architecture/run_history.md) are all shipped (Milestones 0–14). See CHANGELOG.md for the full release notes and docs/roadmap.md for what's next. The 0.x API is not yet stable and may change without a major-version bump, per SemVer's 0.x convention.

Architecture

QML Observer pipeline: training loop through an adapter into QMLMonitor, statistics, detectors, diagnosis engine, and action policy, which logs, warns, or stops training

Training events flow one-way through the pipeline above; nothing here ever owns or drives the quantum computation itself (plan.md §2). See docs/architecture/overview.md for the full, module-by-module breakdown, including the diagnosis engine's weighted-evidence scoring and the opt-in telemetry layer.

Development Status
- 4 - Beta
Intended Audience
- Science/Research
Operating System
- OS Independent
Programming Language
Topic
- Scientific/Engineering :: Physics

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

qml_observer-0.7.0.tar.gz (952.7 kB view details)

Uploaded Aug 3, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

qml_observer-0.7.0-py3-none-any.whl (231.2 kB view details)

Uploaded Aug 3, 2026 Python 3

File details

Details for the file qml_observer-0.7.0.tar.gz.

File metadata

Download URL: qml_observer-0.7.0.tar.gz
Upload date: Aug 3, 2026
Size: 952.7 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for qml_observer-0.7.0.tar.gz
Algorithm	Hash digest
SHA256	`2b0289c8c95225e557fd0b1c5b60c99dbc2acb7fc8ae7d47e868e70f87f86ff8`
MD5	`00f054b4f7777fefe8d44562fdd9fa26`
BLAKE2b-256	`9157eaba8cb6acf943637e9fb800a125ff6f91eaf9f827779908e2c2f32b0537`

See more details on using hashes here.

Provenance

The following attestation bundles were made for qml_observer-0.7.0.tar.gz:

Publisher: release.yml on insightlabs38-pixel/QML-Observer

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: qml_observer-0.7.0.tar.gz
- Subject digest: 2b0289c8c95225e557fd0b1c5b60c99dbc2acb7fc8ae7d47e868e70f87f86ff8
- Sigstore transparency entry: 2332619130
- Sigstore integration time: Aug 3, 2026
Source repository:
- Permalink: insightlabs38-pixel/QML-Observer@c99441806f35196917707714d0e11dfec4efceaa
- Branch / Tag: refs/tags/v0.7.0
- Owner: https://github.com/insightlabs38-pixel
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: release.yml@c99441806f35196917707714d0e11dfec4efceaa
- Trigger Event: push