PauLie

The PauLie package is an open-source library for studying various algebraic properties of quantum circuits. This first release focuses on the classification of the circuit's dynamical Lie algebra given the generators as Pauli strings.

Installation

PauLie package requires Python 3.12 or newer. To install PauLie, run:

pip install paulie

Getting started

The following code gives an example of usage:

    from paulie import get_pauli_string as p
    
    n_qubits = 6
    generators = p(["XYZX", "ZZYZY"], n = n_qubits)
    algebra = generators.get_algebra()
    print(f"number of qubits = {n_qubits}, algebra = {algebra}")

Contributing

Feel free to contribute and check out our open issues. We are also happy to chat with you via Discord.

Clone the repository. Once you have uv installed, run the following command to install all dependencies:

uv sync --all-extras --dev

Testing

In order to run the test suite, run:

uv run python -m pytest

Type Checking

Check for type errors, improve readability, and assist IDEs, run:

uv run mypy src/paulie/common src/paulie/classifier/classification.py

Citation

You can cite the package as @software{paulie2026, author = {Shaya, Oxana and Golovkin, Konstantin and Roy, Mainak and Russo, Vincent and {The PauLie Contributors}}, title = {{PauLie}}, year = {2026}, url = {https://github.com/QPauLie/PauLie} }.