Summary

Closes#2054.

This PR adds an interactive command-line interface (CLI) that guides users through saving their account to disk. This should be easier for users as they can just run one command and be guided through the relevant choices, and it should be more secure as they're discouraged from storing their token in code they might share.

Withqiskit-ibm-runtime installed, users will be able to run the following command to start the CLI.

qiskit-ibm-runtime save-account

This should also be compatible withpipx run, so users will be able to runpipx run qiskit-ibm-runtime save-account from any environment.

Examples

Here's a screenshot of me saving my account correctly.

Here's the output of--help:

(.venv) ~ $ qiskit-ibm-runtime --help      usage: qiskit-ibm-runtime [-h] {save-account} ...Scripts for the Qiskit IBM Runtime Python packageoptions:  -h, --help      show this help message and exitScripts:  This package supports the following scripts:  {save-account}    save-account  Interactive command-line interface to save your account locally.

Questions

What should I add to the documentation? I don't think it belongs in the API documentation in this repo as we don't want users to import these functions. Maybe we can add a note underQiskitRuntimeService.save_account recommending this instead? When released, we can update the guides.