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.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.

Project links

Data verified by PyPI on Aug 3, 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:
Latest release

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 Aug 3, 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 jax mlflow pennylane qiskit torch wandb

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.7.0.tar.gz (952.7 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.7.0-py3-none-any.whl (231.2 kB view details)

Uploaded 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:
  • 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.

File details

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

File metadata

  • Download URL: qml_observer-0.7.0-py3-none-any.whl
  • Upload date:
  • Size: 231.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.7.0-py3-none-any.whl
Algorithm Hash digest
SHA256 ad386b74d93e6e502f867d3618d590c5dc2019c2509b78663fdeb7dfceb16d0f
MD5 e310468c72053001a079160b2b1c0f89
BLAKE2b-256 445e5c5384fc541a55e4c05485acc24b8bf65952a54bed31707fa8734957d9f9

See more details on using hashes here.

Provenance

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

This release

0.7.0 This release

2 files

0.6.0

2 files

0.5.0

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