Extending

MicroQuantum is designed to be extended without forks. The SDK itself stays NumPy-only; all hardware/vendor specifics live behind boundaries.

Extension points

General rules

  1. Vendor types never leak through the SDK surface — map them into BackendResult / capabilities at the boundary.

  2. The SDK must never import a vendor/enterprise package; extensions are optional and live outside src/microquantum.

  3. Follow the docstring conventions (Google style) so autoapi documents your extension automatically.

  4. Keep results typed and serializable — consistency with the core result contracts is what makes analysis/experiments work on your extension.