Pre-release

This release is a pre-release and may not be stable for production use.

Ket Quantum Programming

Ket is an embedded programming language that introduces the ease of Python to quantum programming, letting anyone quickly prototype and test a quantum application.

Python is the most widely used programming language for machine learning and data science and has been the language of choice for quantum programming. Ket is a Python-embedded language, but many can use it as a Python library in most cases. So you can use Ket together with NumPy, SciPy, Pandas, and other popular Python libraries.

Ket's goal is to streamline the development of hardware-independent classical quantum applications by providing transparent interaction of classical and quantum data. See https://quantumket.org to learn more about Ket.

Installation ⬇️

Ket requires Python 3.10 or newer and is available for Linux, Windows, and macOS (both Apple silicon and Intel). If you are using a non-x86_64 (Intel/AMD) CPU, such as ARM, on Linux or Windows, you will need to install Rust before installing Ket.

You can install Ket using pip. To do so, copy and paste the following command into your terminal:

pip install ket-lang

Documentation 📜

Documentation available at https://quantumket.org.

Examples 💡

Grover's Algorithm

import ket
from math import sqrt, pi


def grover(size: int, oracle) -> int:
    p = ket.Process(simulator="dense", num_qubits=size)
    s = ket.H(p.alloc(size))
    steps = int((pi / 4) * sqrt(2**size))
    for _ in range(steps):
        oracle(s)
        with ket.around(ket.cat(ket.H, ket.X), s):
            ket.CZ(*s)
    return ket.measure(s).value


size = 8
looking_for = 13
print(grover(size, ket.qulib.oracle.phase_oracle(looking_for)))
# 13

Quantum Teleportation

import ket


def bell(qubits):
    """Prepare a Bell (maximally entangled) pair."""
    return ket.ctrl(ket.H(qubits[0]), ket.X)(qubits[1])


def teleport(alice_msg, alice_aux, bob_aux):
    """Teleport the quantum state of alice_msg to bob_aux."""
    ket.ctrl(alice_msg, ket.X)(alice_aux)
    ket.H(alice_msg)

    m0 = ket.measure(alice_msg)
    m1 = ket.measure(alice_aux)

    if m1.value == 1:
        ket.X(bob_aux)
    if m0.value == 1:
        ket.Z(bob_aux)

    return bob_aux


p = ket.Process(execution="live")

alice = p.alloc()   # alice = |0⟩
ket.H(alice)        # alice = |+⟩
ket.Z(alice)        # alice = |–⟩

bob = teleport(alice, *bell(p.alloc(2)))  # bob ← alice
ket.H(bob)          # bob   = |1⟩
print("Expected measure 1, result =", ket.measure(bob).value)
# Expected measure 1, result = 1

Setup for Ket Development 🔨

To get started with Ket development, follow these steps:

Rust Installation

Ensure that Rust is installed on your system. If not, follow the Rust install guide.

Important: For Rust development, make sure to use the exact same rustc version as the current ket distribution. This version-matching is not required if you are developing with Python or C FFI.

Clone and Compile

Clone the Ket repository and compile the Rust libraries:

git clone --recursive https://gitlab.com/quantum-ket/ket.git
cd ket

cargo build -F c_api --manifest-path src/ket/clib/libs/libket/Cargo.toml
cargo build --manifest-path src/ket/clib/libs/kbw/Cargo.toml

# Create symlinks from within the libs directory
ln -s libket/target/debug/libket.so src/ket/clib/libs/libket.so
ln -s kbw/target/debug/libkbw.so src/ket/clib/libs/libkbw.so

Set Up Virtual Environment

Set up a virtual environment for Python:
```
python3 -m venv venv
source venv/bin/activate
```
Install Dependencies

Upgrade pip and install development requirements:
```
pip install -U pip
pip install -r requirements_dev.txt
```
Install Ket

Install Ket in editable mode:
```
pip install -e .
```
Run Tests

To ensure everything is correctly installed, run the tests:
```
pytest
```

You're now set up for Ket development! Happy coding! 🚀

Cite Ket 📖

When using Ket for research projects, please cite:

Evandro Chagas Ribeiro da Rosa and Rafael de Santiago. 2021. Ket Quantum Programming. J. Emerg. Technol. Comput. Syst. 18, 1, Article 12 (January 2022), 25 pages. DOI: 10.1145/3474224

@article{ket,
   author = {Evandro Chagas Ribeiro da Rosa and Rafael de Santiago},
   title = {Ket Quantum Programming},
   year = {2021},
   issue_date = {January 2022},
   publisher = {Association for Computing Machinery},
   address = {New York, NY, USA},
   volume = {18},
   number = {1},
   issn = {1550-4832},
   url = {https://doi.org/10.1145/3474224},
   doi = {10.1145/3474224},
   journal = {J. Emerg. Technol. Comput. Syst.},
   month = oct,
   articleno = {12},
   numpages = {25},
   keywords = {Quantum programming, cloud quantum computation, qubit simulation}
}

Download files

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

Source Distribution

ket_lang-0.10.3.dev1.tar.gz (215.8 kB view details)

Uploaded Aug 28, 2026 Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

ket_lang-0.10.3.dev1-py3-none-win_amd64.whl (6.9 MB view details)

Uploaded Aug 28, 2026 Python 3Windows x86-64

ket_lang-0.10.3.dev1-py3-none-manylinux_2_28_x86_64.whl (4.6 MB view details)

Uploaded Aug 28, 2026 Python 3manylinux: glibc 2.28+ x86-64

ket_lang-0.10.3.dev1-py3-none-macosx_14_0_universal2.whl (8.1 MB view details)

Uploaded Aug 28, 2026 Python 3macOS 14.0+ universal2 (ARM64, x86-64)

File details

Details for the file ket_lang-0.10.3.dev1.tar.gz.

File metadata

Download URL: ket_lang-0.10.3.dev1.tar.gz
Upload date: Aug 28, 2026
Size: 215.8 kB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.10.21

File hashes

Hashes for ket_lang-0.10.3.dev1.tar.gz
Algorithm	Hash digest
SHA256	`f577c705a39891944ac1e9221f9994816e68c97097e49fe1da91ba111da177ec`
MD5	`f4e73bddc27376a7e828f32eb810b2c9`
BLAKE2b-256	`15a8c57b5169799e39e3b763a4043b45557fe7bd73c82cae9a7b621e5c0469b1`

See more details on using hashes here.

File details

Details for the file ket_lang-0.10.3.dev1-py3-none-win_amd64.whl.

File metadata

Download URL: ket_lang-0.10.3.dev1-py3-none-win_amd64.whl
Upload date: Aug 28, 2026
Size: 6.9 MB
Tags: Python 3, Windows x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.10.21

File hashes

Hashes for ket_lang-0.10.3.dev1-py3-none-win_amd64.whl
Algorithm	Hash digest
SHA256	`4f9a6111d64147ff59cc7f5c48a3885944803f5633b8fb3368424ca33a14ee4d`
MD5	`2870fa2ffcd21efac49e1d9a6e596135`
BLAKE2b-256	`1bd71bdf1da062f2ce8dabdb3839dc4e9ac96de15027ca1b5bb65dbab1a94811`

See more details on using hashes here.

File details

Details for the file ket_lang-0.10.3.dev1-py3-none-manylinux_2_28_x86_64.whl.

File metadata

Download URL: ket_lang-0.10.3.dev1-py3-none-manylinux_2_28_x86_64.whl
Upload date: Aug 28, 2026
Size: 4.6 MB
Tags: Python 3, manylinux: glibc 2.28+ x86-64
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.10.21

File hashes

Hashes for ket_lang-0.10.3.dev1-py3-none-manylinux_2_28_x86_64.whl
Algorithm	Hash digest
SHA256	`30ce735027d19378949f527e46220a1abd3de9379527738584dd604ee1372168`
MD5	`598e622e4065cdeee746b38e2572470d`
BLAKE2b-256	`ee61cbfef4f652f9e6c318ab771d6fb48abae7552baa909ef3cdb1fcfcf24aa0`

See more details on using hashes here.

File details

Details for the file ket_lang-0.10.3.dev1-py3-none-macosx_14_0_universal2.whl.

File metadata

Download URL: ket_lang-0.10.3.dev1-py3-none-macosx_14_0_universal2.whl
Upload date: Aug 28, 2026
Size: 8.1 MB
Tags: Python 3, macOS 14.0+ universal2 (ARM64, x86-64)
Uploaded using Trusted Publishing? No
Uploaded via: twine/7.0.0 CPython/3.14.6

File hashes

Hashes for ket_lang-0.10.3.dev1-py3-none-macosx_14_0_universal2.whl
Algorithm	Hash digest
SHA256	`1a41f3797aa4b0ff63520f1fb3cf3a962fb7f65396be911bcb506c788a9e3f43`
MD5	`cceb72a93ec40a4bb3df94a4c7947d6b`
BLAKE2b-256	`b504359e41751a5163e391f6d045eb619316fbfa24d3d9f96dda8c2803936729`