Metadata-Version: 2.5
Name: bloqade
Version: 0.38.0
Summary: The software development toolkit for neutral atom arrays.
Author-email: Roger-luo <rluo@quera.com>, kaihsin <khwu@quera.com>, weinbe58 <pweinberg@quera.com>, johnzl-777 <jlong@quera.com>, rafaelha <rhaenel@quera.com>
License-File: LICENSE
Classifier: Development Status :: 3 - Alpha
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Requires-Python: >=3.11
Requires-Dist: bloqade-analog~=0.16.9
Requires-Dist: bloqade-circuit[cirq,qasm2,qasm3,qbraid,stim,vis]~=0.15.6
Requires-Dist: bloqade-core~=0.6.15
Requires-Dist: bloqade-decoders>=0.7.0
Requires-Dist: bloqade-lanes>=0.13.0
Requires-Dist: bloqade-ppvm~=0.3.0
Requires-Dist: bloqade-tsim~=1.1.0
Requires-Dist: kirin-toolchain~=0.22.21
Requires-Dist: numpy>=2.2.6
Requires-Dist: rustworkx>=0.17.1
Requires-Dist: scipy>=1.15.3
Requires-Dist: typing-extensions>=4.12
Provides-Extra: atom-vis
Requires-Dist: bloqade-lanes[visualization]; extra == 'atom-vis'
Requires-Dist: kaleido<2,>=1.0.0; extra == 'atom-vis'
Requires-Dist: plotly<8,>=6.1.1; extra == 'atom-vis'
Provides-Extra: circ-opt
Requires-Dist: bloqade-circuit[cirq-parallelize]; extra == 'circ-opt'
Provides-Extra: cudaq
Requires-Dist: cudaq>=0.13.0; (sys_platform != 'win32') and extra == 'cudaq'
Requires-Dist: qbraid-qir[squin]>=0.5.1; (sys_platform != 'win32') and extra == 'cudaq'
Provides-Extra: decoding
Requires-Dist: bloqade-decoders[milp,mld,mle,mwpf,sinter]; extra == 'decoding'
Requires-Dist: bloqade-decoders[tesseract]; (python_version >= '3.12') and extra == 'decoding'
Requires-Dist: pulp<4,>=2.9; extra == 'decoding'
Provides-Extra: pyqrack-accel
Requires-Dist: bloqade-circuit[pyqrack-cuda,pyqrack-opencl]; extra == 'pyqrack-accel'
Provides-Extra: sim
Requires-Dist: bloqade-lanes[sim]; extra == 'sim'
Requires-Dist: clifft; (python_version >= '3.12') and extra == 'sim'
Description-Content-Type: text/markdown

# Welcome to Bloqade -- QuEra's Neutral Atom SDK

[![CI](https://github.com/QuEraComputing/bloqade/actions/workflows/ci.yml/badge.svg)](https://github.com/QuEraComputing/bloqade/actions/workflows/ci.yml)
[![codecov](https://codecov.io/gh/QuEraComputing/bloqade/graph/badge.svg?token=BpHsAYuzdo)](https://codecov.io/gh/QuEraComputing/bloqade)
[![Supported Python versions](https://img.shields.io/pypi/pyversions/bloqade.svg?color=%2334D058)](https://pypi.org/project/bloqade)
[![Documentation](https://img.shields.io/badge/Documentation-6437FF)](https://queracomputing.github.io/bloqade/)
[![DOI](https://zenodo.org/badge/629628885.svg)](https://zenodo.org/doi/10.5281/zenodo.11114109)


Bloqade is QuEra's Python SDK for neutral atom quantum computing. This
repository contains the [Gemini SDK](https://github.com/QuEraComputing/bloqade/tree/main/src/bloqade/gemini),
which provides logical and physical kernels, device and simulator interfaces,
and decoding workflows. Installing `bloqade` also installs the companion
packages for circuit and analog programming, compilation, simulation, and decoding.

> [!IMPORTANT]
>
> This project is in the early stage of development. API and features are subject to change.

## Installation

### Install via `uv` (Recommended)

```bash
uv add bloqade
```

Import the Gemini SDK with `from bloqade import gemini`. For the default
dependencies and optional extras, see the [package overview](https://github.com/QuEraComputing/bloqade/blob/main/src/bloqade/README.md).
The [Gemini migration notes](GEMINI_MIGRATION.md) describe which APIs moved
from `bloqade-lanes` and which versions work together.

## Documentation

The documentation is available at [https://queracomputing.github.io/bloqade/latest/](https://queracomputing.github.io/bloqade/latest/). We are at an early stage of completing the documentation with more details and examples, so comments and contributions are most welcome!

## Contributing

We welcome contributions! Please check the [contribution guidelines](https://queracomputing.github.io/bloqade/latest/contrib/) for a detailed guide.

> [!NOTE]
>
> We welcome contributions that use AI assistance. However, **we ask that first-time contributors do not submit AI-generated PRs**.


## License

Apache License 2.0 with LLVM Exceptions
