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.4.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), and an optional read-only dashboard (qml-observer[dashboard]: live loss/gradient charts, a diagnosis panel, compute-usage panel, run history, and data export) are all shipped (Milestones 0–11). 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 30, 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 30, 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.4.0.tar.gz (833.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.4.0-py3-none-any.whl (149.4 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: qml_observer-0.4.0.tar.gz
  • Upload date:
  • Size: 833.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.4.0.tar.gz
Algorithm Hash digest
SHA256 624644f6aef6849cfc3ef46c0db953a3ddbbf6459560bc2853a7b97fdd78ef6d
MD5 0486705a192f503d56f7ccfb7eeb81b3
BLAKE2b-256 5430b7c73ee40c7983b7c80c3bada9fdc80b9b3272df298cc2f966b5f8963670

See more details on using hashes here.

Provenance

The following attestation bundles were made for qml_observer-0.4.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.4.0-py3-none-any.whl.

File metadata

  • Download URL: qml_observer-0.4.0-py3-none-any.whl
  • Upload date:
  • Size: 149.4 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.4.0-py3-none-any.whl
Algorithm Hash digest
SHA256 cb5a071d1e0835b0151a69b60a4712df6d57d17999324dab096a1e156b2f2c65
MD5 641faf5cb23acf6039f085477a840167
BLAKE2b-256 18ac21a509478828c04cfc6dae28d57b510f9bd9eaa33e86d5fa7da70041ffdf

See more details on using hashes here.

Provenance

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

Supported by

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