Skip to main content

hybridlane banner

hybridlane

hybridlane is a Python library for designing and manipulating hybrid continuous-variable (CV) and discrete-variable (DV) quantum circuits within the PennyLane ecosystem. It provides a frontend for expressing hybrid quantum algorithms, implementing the concepts from the paper Y. Liu et al, 2026 (PRX Quantum 7, 010201).

PyPI - Version Docs PyPI Downloads Build Status License

🚀 Features

  • ⚛️ Heterogeneous quantum circuits: Mix qubits and qumodes in the same circuit, and use our symbolic hybrid gate library to scalably build quantum algorithms.

  • 🤝 PennyLane compatibility: Utilize existing PennyLane gates, write compilation passes as transforms, build custom hybrid backends for hardware, and perform resource estimation across mixed-variable systems.

  • 💻 Classical simulation: Dispatch to our Jax-compatible simulator for accelerated CPU and GPU simulation and take gradients using automatic differentiation, or use Bosonic Qiskit.

  • 💾 OpenQASM-based IR: Leverage our intermediate representation extending OpenQASM to reduce the effort of building new hybrid backends and to facilitate interoperability with other quantum software.


⚙️ Installation

Install the package from PyPI:

pip install hybridlane

For more details on installation and optional dependencies, see the installation guide.

[!WARNING] hybridlane is currently in active development and may experience breaking changes -- consider using version pinning. We welcome your feedback on our GitHub Issues page to help us improve the software.


⚡ Quick Start

import numpy as np
import pennylane as qp
import hybridlane as hl

# Create a simulator with a custom Fock truncation
dev = qp.device("default.hybrid", fock_level=8)


# Define a hybrid circuit with familiar PennyLane syntax
@qp.qnode(dev)
def circuit(n):
    for j in range(n):
        qp.X(0)  # Wire `0` is inferred to be a qubit
        # Use hybrid CV-DV gates from hybridlane
        hl.JC(np.pi / (2 * np.sqrt(j + 1)), np.pi / 2, [0, "m"])

    # Mix qubit and qumode observables
    return hl.expval(hl.N("m") @ qp.Z(0))


# Execute the circuit
expval = circuit(5)
# array(5.)

# Perform wire type checking
res = hl.type_check(circuit)(5)
print(res.wire_types)
# OrderedDict({0: Qubit(), 'm': Qumode()})

For more examples, explore the documentation.


🗺️ Roadmap

hybridlane is under active development. Here are some of our future goals:

  • Broader measurement support: Including mid-circuit measurements and broader measurement capabilities.
  • Algorithms and transformations: Implementing popular algorithms and circuit transformations from research papers, including dynamic qumode allocation.
  • Symbolic Hamiltonians: Introducing support for symbolic bosonic Hamiltonians.
  • Noisy simulation: Supporting noisy quantum simulations, possibly with Dynamiqs.
  • Catalyst/QJIT support: Integrating with PennyLane's qjit capabilities by developing a custom MLIR dialect.
  • Community-driven features: Incorporating features requested by the community during usage.

Citing hybridlane

If you find hybridlane useful in your research, you can cite our paper:

@misc{furches2026hybridlane,
      title={Hybridlane: A Software Development Kit for Hybrid Continuous-Discrete Variable Quantum Computing},
      author={Jim Furches and Timothy J. Stavenger and Carlos Ortiz Marrero},
      year={2026},
      eprint={2603.10919},
      archivePrefix={arXiv},
      primaryClass={quant-ph},
      url={https://arxiv.org/abs/2603.10919},
}

📜 License

This project is licensed under the BSD 2-Clause License - see the LICENSE.txt file for details.


🙏 Acknowledgements

This project was supported by the U.S. Department of Energy, Office of Science, Advanced Scientific Computing Research program under contract number DE-FOA-0003265.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

hybridlane-0.8.0.tar.gz (111.9 kB view details)

Uploaded Source

Built Distribution

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

hybridlane-0.8.0-py3-none-any.whl (157.6 kB view details)

Uploaded Python 3

File details

Details for the file hybridlane-0.8.0.tar.gz.

File metadata

  • Download URL: hybridlane-0.8.0.tar.gz
  • Upload date:
  • Size: 111.9 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for hybridlane-0.8.0.tar.gz
Algorithm Hash digest
SHA256 c2aca6775e61d144e27654dbf0d4a9ea695e30fef7717409d036a27bb9c205c7
MD5 a22ef7243a82b36edce865078deb07b3
BLAKE2b-256 1ec151632a0e57c8971e260a6a719f0b20cb33ebcff8e1827b4686c503720442

See more details on using hashes here.

File details

Details for the file hybridlane-0.8.0-py3-none-any.whl.

File metadata

  • Download URL: hybridlane-0.8.0-py3-none-any.whl
  • Upload date:
  • Size: 157.6 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.12.6 {"installer":{"name":"uv","version":"0.12.6","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}

File hashes

Hashes for hybridlane-0.8.0-py3-none-any.whl
Algorithm Hash digest
SHA256 2d291acd4e490fdc130018a2f4cfd0ee8e92a1ccdba569b245c1ee6f80fd89fb
MD5 a6d1c8d8def472757a010f88a07d9746
BLAKE2b-256 b8c9cc435640b660797bdfc697ecef015c828805e8d8a9b75f0efc648f040d19

See more details on using hashes here.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page