Quantum-classical hybrid workflow orchestration tool. This is the top level repository containing the python packages.

• Tierkreis: the core functionality pip install tierkreis
• Tierkreis Visualization: A simple web visualization tool for debugging workflows pip install tierkreis-visualization
• Tierkreis Workers: A collection of commonly used workers pip install tkr-<name>-worker
  • Qiskit Aer
  • Quantinuum Nexus
  • Quantinuum PyTKet

Tierkreis comes with a command line interface for running workflows. To see all available options use tkr --help. To run the hello world example from the cli

uv run tkr -g examples/hello_world/hello_world_graph.py:hello_graph -i data.json --uv --registry-path examples/hello_world/ -o

Explanation:

• -g specifies the graph to run by specifying the location and function to run.
• -i specifies the input for the graph function. In this case it loads a json file from the project root with the contents {"value": "world!"}
• --uv enables the use of the UV executor.
• --registry-path specifies the location of the registry to use for the UV executor.
• -o enables output printing.

Requirements

• uv >= 0.4

See the justfile (requires just) for common development commands. For example:

just test

To build the documentation locally, run the command in the top level justfile.

just docs

Documentation will be built in HTML format by default and will be available in the docs/build/html folder.

For documentation we use the MyST parser with markdown files.

This project is licensed under Apache License, Version 2.0 (LICENSE or http://www.apache.org/licenses/LICENSE-2.0).