Quantum Challenge Grader

Grading client for the IBM Quantum Challenge grading service.

Run locally

Pre-requisites:

To install the grader locally:

  1. In the Python environment, install the grading client: pip install qc-grader

  2. Configure the QC_API_KEY environment variables

    From a terminal (before launching your JupyterLab environment), enter

    export QC_API_KEY=your_ibmcloud_api_key

    where your_ibmcloud_api_key is your IBM Cloud API Key found in your Account page.

    Alternatively, if you prefer you can instead run the following at the top cell of a notebook cell (whenever you start/restart the kernel)

    %set_env QC_API_KEY=your_ibmcloud_api_key

    Note1: you can check if the environment variable has been set by running the following in a notebook cell:

    import os
print(os.getenv('QC_API_KEY'))

    Note2: If you already installed qiskit-ibm-runtime and saved your token by using QiskitRuntimeService by following this instruction once, you don't need to set-up the env variable. You can save your token by using QiskitRuntimeService like below:

    from qiskit_ibm_runtime import QiskitRuntimeService
QiskitRuntimeService.save_account(
    channel="ibm_quantum",
    token="<YOUR_TOKEN>",
    set_as_default=True,
    overwrite=True,
)

Usage

  1. Open an exercise notebook

    • In IBM Quantum Lab, the notebooks can be found in the quantum-challenge folder in the Lab files panel
    • For local install, download the notebooks (from IBM Quantum Lab or specific challenge repo) and import into local Jupyter environment

  2. Run the notebook cells, answering the exercises and submitting solution for grading. For example

    from qc_grader.challenges.challenge_2021 import grade_lab1_ex1 

grade_lab1_ex1(qc_1)

    from qc_grader.challenges.challenge_2021 import grade_lab1_ex2 

grade_lab1_ex2(qc_2)

Project links

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (2026.7.28)

4 maintainers

PyPI data
Data sourced directly from PyPI's database.
Avatar for EricArellano from gravatar.com EricArellano Avatar for faf-zurich from gravatar.com faf-zurich Avatar for frankharkins from gravatar.com frankharkins
+1 more Avatar for rachaelhouse from gravatar.com rachaelhouse

Credits

Author: IBM Quantum Community Team

License

Apache Software License (Apache-2.0)

Requires

Python >=3.10

Tags

challenge grader qiskit quantum

Classifiers

Report project as malware

Download files

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

Source Distribution

qc_grader-2026.7.16.tar.gz (141.4 kB view details)

Uploaded Source

Built Distribution

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

qc_grader-2026.7.16-py3-none-any.whl (54.3 kB view details)

Uploaded Python 3

File details

Details for the file qc_grader-2026.7.16.tar.gz.

File metadata

  • Download URL: qc_grader-2026.7.16.tar.gz
  • Upload date:
  • Size: 141.4 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qc_grader-2026.7.16.tar.gz
Algorithm Hash digest
SHA256 c7749c45d84143abbbf9613e54d815e14a2aaf839b03c47c4e41a58b9ecf1ce6
MD5 f11653b4f96664fa91a0348c25a0002e
BLAKE2b-256 bcb2a5575d8c513a870df4f38345f7665f83cb6d20e36014abdf0f3419285034

See more details on using hashes here.

Provenance

The following attestation bundles were made for qc_grader-2026.7.16.tar.gz:

Publisher: release.yml on qiskit-community/Quantum-Challenge-Grader

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file qc_grader-2026.7.16-py3-none-any.whl.

File metadata

  • Download URL: qc_grader-2026.7.16-py3-none-any.whl
  • Upload date:
  • Size: 54.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for qc_grader-2026.7.16-py3-none-any.whl
Algorithm Hash digest
SHA256 d0914caa30be26e2d1831e45ac3d83e2ab9c3f40f24e3a6f5ba677989d7d726f
MD5 a3e7ba85ff4d4c52fa9516a7ea6e2338
BLAKE2b-256 764a6282055d297fcf5a88f6e399f4d836c7578c2bd0a283663ac77e17955346

See more details on using hashes here.

Provenance

The following attestation bundles were made for qc_grader-2026.7.16-py3-none-any.whl:

Publisher: release.yml on qiskit-community/Quantum-Challenge-Grader

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page