/Quantum-Challenge-Grader

Grading client for the IBM Quantum Challenges

Primary LanguagePythonApache License 2.0Apache-2.0

Quantum Challenge Grader

Grading client for the IBM Quantum Challenge grading service.

Installation

Follow one of these steps to install the grading client.

Run in IBM Quantum Lab

Pre-requisites:

The grader comes pre-installed in Quantum Lab and does not need to be installed. You can confirm and check version with the following command in a notebook cell:

!pip show qc_grader

Run locally

Pre-requisites:

To install the grader locally:

  1. In the Python environment, install the grading client

    pip install git+https://github.com/qiskit-community/Quantum-Challenge-Grader.git
    
  2. Configure the following environment variables

    • QXAuthURL - IBM Quantum Authentication API URL
    • QXToken - IBM Quantum API Token (can be found in Account Details)

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)