New in Quantum Cloud Services, you can now easily book and manage reservations on Rigetti's QPU lattices using the QCS dashboard or command-line interface.  

  • Booking a new reservation using the QCS Dashboard
    On the dashboard, you can simply select the duration, date, and time to start browsing for a lattice of choice.reserve time on QCS
  • Booking a new reservation using the QCS CLI
    First, you'll need to select a lattice that you would like to reserve and execute your program with. To use this functionality, you'll need to be connected to your QMI.

    To view a list of all available lattices, use the following command:
  • $ qcs lattices

    All available lattices will be displayed, ordered by number of qubits (low-to-high), for example:
    Copy the name of the lattice you'd like to reserve, for example Aspen-0-6Q-C

    Next, to book a reservation for your selected lattice, type:

    $ qcs reserve --help

    You'll be presented with a list of options to include for booking your lattice at a preferred time and duration.
    qcs reserve --helpAll times are displayed in your local time zone—specifically, based on your browser location at the time in which you uploaded your SSH key to QCS.

    If the date and time you entered are not available, the CLI will automatically propose the next available times for you to accept or decline. To book a proposed time, simply enter y to confirm and you'll receive a confirmation message. To decline and try an alternative time, enter n and the next available time will be proposed.

  • Viewing your current and upcoming reservations
    You can view a list of your scheduled reservations with the following command:
    $ qcs reservations


  • Changing or canceling an existing reservation
    To change an upcoming reservation, you'll need to cancel it and book a new reservation.

    To cancel from the dashboard, scroll down to the section labeled upcoming reservations and click red bin icon to cancel.

    To cancel using the CLI, first locate the ID of the reservation by using the qcs reservations command. Next, use qcs cancel command and enter y when prompted to confirm your cancellation.
    $ qcs cancel -i <PASTE_RESERVATION_ID>

    Then, to book a new reservation, follow the instructions above.

  • Preparing for your upcoming reservation
    Once you've scheduled a reservation, here's some tips to help you get the most out of your reserved time:

    • Begin developing your program locally, and then copy your file to your QMI. You can continue editing this file on your QMI using third-party tools, or simply replace this file with an updated version.

    • Test and run your program on the QVM simulator before your reservation begins. Refer to the ForestTM SDK docs for more details on using the QVM. Here are some tips:

    • When running your program on the QVM simulator, remember to target the corresponding lattice in which you've reserved:

      get_qc(<LATTICE_NAME>, as_qvm=True)
    • After testing your program on the QVM simulator, remember to update your program to target the lattice (rather than the QVM) by setting as_qvm=False.

    • To queue your program to automatically execute at the start of your reservation, rather than having to manually initialize its execution, follow this guide. Alternatively, during your reserved time, you can execute your program manually (i.e. $ python <YOUR_FILE_NAME>), run a Jupyter notebook, interact with your lattice in iPython from your Terminal, or work in whatever way you prefer.  

  • Support
    If you need help with scheduling or managing your reservations, contact our support team at