This repository holds the documentation of the lambeq Python library.

lambeq is a toolkit for quantum natural language processing (QNLP).

• Documentation: https://cqcl.github.io/lambeq-docs/
• User support: lambeq-support@quantinuum.com
• Contributions: Please read our guide.
• If you want to subscribe to lambeq's mailing list, let us know by sending an email to lambeq-support@quantinuum.com.

• Python 3.10+

lambeq can be installed with the command:

pip install lambeq

The default installation of lambeq includes Bobcat parser, a state-of-the-art statistical parser (see related paper) fully integrated with the toolkit.

To install lambeq with optional dependencies for extra features, run:

pip install lambeq[extras]

To enable DepCCG support, you will need to install the external parser separately.

Note: The DepCCG-related functionality is no longer actively supported in lambeq, and may not work as expected. We strongly recommend using the default Bobcat parser which comes as part of lambeq.

If you still want to use DepCCG, for example because you plan to apply lambeq on Japanese, you can install DepCCG separately following the instructions on the DepCCG homepage. After installing DepCCG, you can download its model by using the script provided in the contrib folder of this repository:

python contrib/download_depccg_model.py

The docs/examples directory contains notebooks demonstrating usage of the various tools in lambeq.

Example - parsing a sentence into a diagram (see docs/examples/parser.ipynb):

from lambeq import BobcatParser

parser = BobcatParser()
diagram = parser.sentence2diagram('This is a test sentence')
diagram.draw()

Run all tests with the command:

pytest

Note: if you have installed lambeq in a virtual environment, remember to install pytest in the same environment using pip.

To build the documentation, first clone locally this repository and install the required dependencies:

pip install -r requirements.txt

then run the command:

./build-docs.sh

The docs will be under the build directory just under the repository root. To serve it locally:

cd build
python -m http.server

and then go to http://localhost:8000 to load the index page.

Distributed under the Apache 2.0 license. See LICENSE for more details.

If you wish to attribute our work, please cite the accompanying paper:

@article{kartsaklis2021lambeq,
   title={lambeq: {A}n {E}fficient {H}igh-{L}evel {P}ython {L}ibrary for {Q}uantum {NLP}},
   author={Dimitri Kartsaklis and Ian Fan and Richie Yeung and Anna Pearson and Robin Lorenz and Alexis Toumi and Giovanni de Felice and Konstantinos Meichanetzidis and Stephen Clark and Bob Coecke},
   year={2021},
   journal={arXiv preprint arXiv:2110.04236},
}