Using Amazon Q Developer with JupyterLab

This page describes how to set up and activate Amazon Q Developer for JupyterLab. Once activated, Amazon Q can make code recommendations automatically as you write your code.

Note

Python is the only programming language that Amazon Q supports in JupyterLab.

Installing JupyterLab

Install JupyterLab on your computer or if you already have JupyterLab installed, check its version by running the following command.

pip show jupyterlab

Note the version in the response, and follow the use the corresponding directions in one of the following sections.

Installation using pip for Jupyter Lab version >= 4.0

You can install and enable the Amazon Q extension for JupyterLab 4 with the following commands.

# JupyterLab 4
pip install amazon-q-developer-jupyterlab-ext

Installation using pip for Jupyter Lab version >= 3.6 and < 4.0

You can install and enable the Amazon Q extension for JupyterLab 3 with the following commands.

# JupyterLab 3
pip install amazon-q-developer-jupyterlab-ext~=1.0
jupyter server extension enable amazon-q-developer-jupyterlab-ext

Authenticating with AWS Builder ID

In the following procedure, you will set up Builder ID, which you will use to authenticate when you enable Amazon Q.

1. Refresh the browser tab on which you are using JupyterLab.

2. From the Amazon Q panel at the bottom of the window, choose Start Amazon Q.

3. From the pop-up window, choose Copy Code and Proceed.

4. On the Create AWS Builder ID page, if you don't have a Builder ID, enter a personal email address and choose Next.

   If you already have a Builder ID, skip to the step about the Authorize request page.

5. On the next Create your AWS Builder ID page, enter a name and choose Next.

6. After you receive your email verification code, enter it in the blank field and choose Verify.

7. On the next screen, choose and confirm a password, then choose Create AWS Builder ID

8. On the next page choose Allow to allow Amazon Q to access your data.

Now you should be logged into Amazon Q in JupyterLab with Builder ID.

To begin coding, see Using shortcut keys.