Metadata-Version: 2.4
Name: qmbed
Version: 0.2.0
Summary: Thin Python bindings for the QMBED Rust core
Author: Matrix Lab
License-Expression: MIT
Project-URL: Documentation, https://matrixlab-research.github.io/QMBED/python/
Project-URL: Repository, https://github.com/matrixlab-research/QMBED
Project-URL: Issues, https://github.com/matrixlab-research/QMBED/issues
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Science/Research
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Rust
Classifier: Topic :: Scientific/Engineering :: Physics
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: numba>=0.59; sys_platform != "darwin" or platform_machine != "x86_64"
Requires-Dist: numba<0.63,>=0.59; sys_platform == "darwin" and platform_machine == "x86_64"
Requires-Dist: numpy>=1.24
Requires-Dist: scipy>=1.10
Provides-Extra: test
Requires-Dist: pytest>=8; extra == "test"
Dynamic: license-file

# QMBED for Python

QMBED is a Rust-native exact-diagonalization toolkit for quantum many-body
workflows. The Python distribution includes:

- the native `qmbed` request API;
- a versioned `quspin` compatibility surface for workflow migration; and
- the compiled QMBED Rust core inside each supported platform wheel.

After the first registry release:

```bash
python -m pip install qmbed
```

Wheels target CPython 3.10–3.14 on Linux, Windows, and Apple Silicon.
Intel macOS wheels stop at CPython 3.13 because the QuSpin compatibility
surface depends on the last Numba release that published Intel Mac binaries.

```python
import qmbed

basis = qmbed.SpinBasis(2)
terms = (
    qmbed.OperatorSpec(
        qmbed.OpProduct((qmbed.LocalOperator.Z, qmbed.LocalOperator.Z)),
        (qmbed.Coupling(1.0, (0, 1)),),
    ),
)
result = qmbed.eigsh(basis, terms, qmbed.EigshOptions(2))
print(result.eigenvalues)
```

See the
[QMBED documentation](https://matrixlab-research.github.io/QMBED/python/)
for supported bases, operators, solvers, observables, and compatibility
boundaries.
