Skip to main content

Extension for pytket, providing access to AQT backends

Project description


Pytket is a python module for interfacing with tket, a quantum computing toolkit and optimising compiler developed by Quantinuum.

pytket-aqt is an extension to pytket that allows pytket circuits to be executed on AQT's (Alpine Quantum Technologies') quantum devices and simulators.

See extension documentation for more.

Getting started

pytket-aqt is available for Python 3.10, 3.11 and 3.12, on Linux, MacOS and Windows. To install, run:

pip install pytket-aqt

This will install pytket if it isn't already installed, and add new classes and methods into the pytket.extensions namespace.

Bugs, support and feature requests

Please file bugs and feature requests on the Github issue tracker.

There is also a Slack channel for discussion and support. Click here to join.


This project uses Poetry for packaging and dependency management and Nox for task automation.

Recommended development setup

Install development tools:

pip install -r dev-tool-requirements.txt

Local development with Nox (recommended)

Nox can be used to automate various development tasks running in isolated python environments. The following Nox sessions are provided:

  • pre-commit: run the configured pre-commit hooks within .pre-commit-config.yaml, this includes linting with black and pylint
  • mypy: run type checks using mypy
  • tests: run the unit tests
  • docs-build: build the documentation

To run a session use:

nox -s <session_name>

To save time, reuse the session virtual environment using the -r option, i.e. nox -rs <session_name> (may cause errors after a dependency update).

Pre-commit can be used to run the pre-commit hooks before each commit. This is recommended. To set up the pre-commit hooks to run automatically on each commit run:

nox -s pre-commit -- install

Afterward, the pre-configured hooks will run on all changed files in a commit and the commit will be rejected if the hooks find errors. Some hooks will correct formatting issues automatically (but will still reject the commit, so that the git commit command will need to be repeated).

Local development without Nox

To install the local package, its dependencies and various development dependencies run:

poetry install --with tests,docs,mypy,pre-commit

This will install the dependencies within an isolated virtual environment managed by Poetry. To activate that environment run:

poetry shell

Within this environment, the following commands can be used:

# run tests
pytest tests
# run mypy
mypy --explicit-package-bases pytket tests docs/ docs/build-docs
# run pre-commit checks
pre-commit run --all-files --show-diff-on-failure
# build documentation

To exit the Poetry environment, run:



Pull requests are welcome. To make a PR, first fork the repo, make your proposed changes on the develop branch, and open a PR from your fork. If it passes tests and is accepted after review, it will be merged in.

Code style

Formatting and Linting

All code will be checked on the CI with black and pylint as configured within the pre-commit checks. These checks should be run locally before any pull request submission using the corresponding nox session or pre-commit directly (see above). The used versions of the formatting ad linting tools is specified in the pyproject.toml.

Type annotation

On the CI, mypy is used as a static type checker and all submissions must pass its checks. You should therefore run mypy locally on any changed files before submitting a PR. This should be done using the method described under Local development with Nox or without Nox.

Adding Tests

When adding a new feature, please add appropriate tests for it within the tests directory. When fixing a bug, please add a test that demonstrates the fix.

Project details

Download files

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

Source Distributions

No source distribution files available for this release.See tutorial on generating distribution archives.

Built Distribution

pytket_aqt-0.33.0-py3-none-any.whl (32.8 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page