QML Observer

CI PyPI Python versions License: MPL-2.0

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.5.0 — public beta. Core schemas, monitoring engine, detectors, diagnosis engine, actions, 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), and 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) are all shipped (Milestones 0–12). 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.

Note: the "pause" action-policy mode currently behaves identically to "warn" — a distinct pause-and-preserve-state action (PauseAction) is planned for Milestone 13 and is not yet implemented. See docs/architecture/actions.md.

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.

Project links

Data verified by PyPI on Jul 31, 2026
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.7.0)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for qml-observer-publishing from gravatar.com qml-observer-publishing

Credits

Author: QML Observer Contributors

GitHub Statistics

Data verified by PyPI on Jul 31, 2026
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

MPL-2.0
View SPDX License List

Requires

Python >=3.12

Provides Extra

dashboard dev pennylane qiskit

Tags

barren plateau observability pennylane qiskit quantum machine learning

Classifiers

Report project as malware

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.5.0.tar.gz (863.1 kB view details)

Uploaded Source

Built Distribution

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

qml_observer-0.5.0-py3-none-any.whl (171.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qml_observer-0.5.0.tar.gz
  • Upload date:
  • Size: 863.1 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.5.0.tar.gz
Algorithm Hash digest
SHA256 6acfa7da4e5801300855bcd0f2348abaa5342fb069917f9da390fcd53908000a
MD5 2b036d8571a0847dc6b69ac587851add
BLAKE2b-256 1741ef965212e9055aff48bf3463c525680063952dabd45cdba2a0ca26b19fc5

See more details on using hashes here.

Provenance

The following attestation bundles were made for qml_observer-0.5.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.

File details

Details for the file qml_observer-0.5.0-py3-none-any.whl.

File metadata

  • Download URL: qml_observer-0.5.0-py3-none-any.whl
  • Upload date:
  • Size: 171.2 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for qml_observer-0.5.0-py3-none-any.whl
Algorithm Hash digest
SHA256 957948e14324e771e0e06dae09248add68c4d95e848c7e9874d754bf25a2b5f3
MD5 da39ad4e7087bf73720e5893445d8ca2
BLAKE2b-256 8f4c12a01541edce7ce302dd5fd5734af3cd46bc2bc9c728c7496c4724d4647b

See more details on using hashes here.

Provenance

The following attestation bundles were made for qml_observer-0.5.0-py3-none-any.whl:

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.

Release history Release notifications | RSS feed

0.7.0

2 files

0.6.0

2 files

This release

0.5.0 This release

2 files

0.4.0

2 files

0.3.0

2 files

0.2.0

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page