diff --git a/docs/guides/_toc.json b/docs/guides/_toc.json
index 025ca5248e8..562661de2ad 100644
--- a/docs/guides/_toc.json
+++ b/docs/guides/_toc.json
@@ -476,9 +476,26 @@
"url": "/guides/serverless-port-code"
}
]
+ },
+ {
+ "title": "Qiskit Code Assistant",
+ "children": [
+ {
+ "title": "Qiskit Code Assistant overview",
+ "url": "/guides/qiskit-code-assistant"
+ },
+ {
+ "title": "Use Qiskit Code Assistant in JupyterLab",
+ "url": "/guides/qiskit-code-assistant-jupyterlab"
+ },
+ {
+ "title": "Use Qiskit Code Assistant in VSCode",
+ "url": "/guides/qiskit-code-assistant-vscode"
+ }
+ ]
}
],
"collapsible": false
}
]
-}
\ No newline at end of file
+}
diff --git a/docs/guides/qiskit-code-assistant-jupyterlab.mdx b/docs/guides/qiskit-code-assistant-jupyterlab.mdx
new file mode 100644
index 00000000000..31285296e2a
--- /dev/null
+++ b/docs/guides/qiskit-code-assistant-jupyterlab.mdx
@@ -0,0 +1,128 @@
+---
+title: Use the Qiskit Code Assistant in JupyterLab
+description: How to install, use, and configure the Qiskit Code Assistant in JupyterLab.
+---
+
+# Use the Qiskit Code Assistant in JupyterLab
+
+Learn how to install, use, configure, and uninstall the official Qiskit Code Assistant extension in JupyterLab.
+
+
+ - This is an experimental feature available only to IBM Quantum™ Premium Plan users.
+ - The Qiskit Code Assistant is in preview release status and is subject to change.
+ - If you have feedback or want to contact the developer team, use the [Qiskit Slack Workspace channel](https://qiskit.enterprise.slack.com/archives/C07LYA6PL83) or the related public GitHub repositories.
+
+
+
+
+
+## Install the JupyterLab extension
+To install the [JupyterLab extension](https://github.com/Qiskit/qiskit-code-assistant-jupyterlab), run the following command from a terminal:
+
+```sh
+pip install qiskit-code-assistant-jupyterlab
+```
+
+After installing the extension, start JupyterLab:
+
+```sh
+jupyter lab
+```
+
+The extension loads automatically and is listed on the bottom of the JupyterLab window.
+
+
+
+Refer to the [JupyterLab documentation.](https://jupyterlab.readthedocs.io/en/latest/) for help working with JupyterLab
+
+## Configure extension settings
+
+It is recommended that you edit the following JupyterLab settings by going to Settings -> Settings Editor:
+
+- Click **Inline Completer**, find "Show widget" and choose **Always**. This means that the the inline completer widget will always be shown so you can cycle through and select a completion item.
+
+- Click **Code Completion** and increase the value for "Default timeout for a provider." to `10000` or 10 seconds. The default value is 1 second, but the Qiskit Code Assistant API might take longer than this to find a suggstion. This setting only applies to the standard context menu that is invoked with `Tab`. The inline completer has a default of 10 seconds.
+
+Other settings you might want to change:
+
+- Keyboard shortcuts can be changed from Settings > Settings Editor > Keyboard Shortcuts.
+
+- You can change the IBM Quantum API token to use in the JupyterLab command palette. To do that, type `Alt` + `Shift` + `C`, search for `qiskit`, select the **Qiskit Code Assistant: Set IBM Quantum API token** command, and paste in your token.
+
+- [Advanced] To change the instance of the Qiskit Code Assistant Service that the extension should use, edit the Qiskit Code Assistant `serviceUrl` setting.
+
+- [Advanced] Keyboard shortcuts can be changed by searching for `completer` in the Keyboard Shortcuts settings (Settings -> Settings Editor -> Keyboard Shortcuts) and adding new shortcuts for the relevant commands.
+
+## Get started using the Qiskit Code Assistant extension for JupyterLab
+
+### Authentication and setup
+
+After installing the extension, it tries to authenticate you. By default, the package tries to authenticate to IBM Quantum services with the defined Qiskit API token, and uses your token from the `QISKIT_IBM_TOKEN` environment variable or from the file `~/.qiskit/qiskit-ibm.json` (under the section `default-ibm-quantum`). If you need help configuring your account, follow the instructions in [Set up to use IBM Quantum Platform.](/guides/setup-channel#set-up-to-use-ibm-quantum-platform)
+
+By default, the extension uses the `granite-8b-qiskit` model, which is listed in the Model Picker in the bottom status bar.
+
+
+
+The first time you use the `granite-8b-qiskit` model a modal opens, listing some major restrictions that you should be aware of when using the model. Clicking `Accept` will accept the disclaimer and enable the model for code generation.
+
+
+
+### Generate Code
+
+While you develop your code using Qiskit, you can ask to the Qiskit Code Assistant to help you. In general, the assistant suggests better code as response to Python comments or docstrings, but you can use the assistant anywhere in your file.
+
+In JupyterLab, there are two ways to use the code autocompletion: inline or in a context menu.
+
+Inline autocomplettion can be triggered by using the following key strokes:
+
+- `Alt` + `.` or `Alt` + `\` runs autocomplete at the current cursor location.
+- `Alt` + `[` and `Alt` + `]` can be used to cycle through the list of suggestions if there are
+ more than one.
+- `Alt` + `Tab` or `Alt` + `END` accepts the suggested code and inserts it at the current
+ cursor location.
+
+Additionally, after the assistant runs, you can use the buttons on the widget to cycle or accept the suggestion:
+
+
+
+
+The service can sometimes take a few seconds to return a suggestion, you can see when the service is working by checking the status bar.
+
+
+Jupyterlab also includes a traditional suggestion context menu. Use the `Tab` key to run and display the context menu.
+
+The context menu includes suggestions from JupyterLab in addition to the Qiskit Code Assistant suggestions. The context menu also sanitizes and trims the suggestions, making it less useful for reviewing the code suggestion before inserting it.
+
+
+
+## Uninstall the JupyterLab extension
+
+
+To remove the Qiskit Code Assistant extension from JupyterLab, run:
+
+```bash
+pip uninstall qiskit_code_assistant_jupyterlab
+```
+
+## Troubleshooting
+
+If you are seeing the frontend extension but it is not working, check that the server
+extension is enabled:
+
+```bash
+jupyter server extension list
+```
+
+If the server extension is installed and enabled, but you are not seeing the frontend
+extension, check the frontend extension is installed:
+
+```bash
+jupyter labextension list
+```
+
+
+## Contribute to the JupyterLab extension
+
+The code for this extension is publicly available and open source. Check it out in [GitHub.](https://github.com/Qiskit/qiskit-code-assistant-jupyterlab)
diff --git a/docs/guides/qiskit-code-assistant-vscode.mdx b/docs/guides/qiskit-code-assistant-vscode.mdx
new file mode 100644
index 00000000000..572fa23d96d
--- /dev/null
+++ b/docs/guides/qiskit-code-assistant-vscode.mdx
@@ -0,0 +1,93 @@
+---
+title: Use the Qiskit Code Assistant in VSCode
+description: How to install, use, and configure the Qiskit Code Assistant in Visual Studio Code (VSCode).
+---
+
+# Use the Qiskit Code Assistant in Visual Studio Code
+
+Learn how to install, use, configure and uninstall the official Qiskit Code Assistant extension in Visual Studio Code (VSCode).
+
+
+ - This is an experimental feature available only to IBM Quantum™ Premium Plan users.
+ - The Qiskit Code Assistant is in preview release status and is subject to change.
+ - If you have feedback or want to contact the developer team, use the [Qiskit Slack Workspace channel](https://qiskit.enterprise.slack.com/archives/C07LYA6PL83) or the related public GitHub repositories.
+
+
+
+
+
+## Install the VSCode extension
+
+To install the [VSCode extension](https://github.com/Qiskit/qiskit-code-assistant-vscode), follow these steps:
+
+1. Launch VS Code.
+1. Click the Extensions icon in the left toolbar.
+1. Search for `qiskit-vscode`
+1. Find "Qiskit Code Assistant" and click **Install**.
+
+The extension is also available through the [VSCode Marketplace](https://marketplace.visualstudio.com/items?itemName=qiskit.qiskit-vscode).
+
+After installing, reload the extension/IDE (typically, VSCode will prompt you to do this automatically). When it's ready, you will see "Qiskit Code Assistant" listed on the bottom of the VS Code window:
+
+
+
+## Configure extension settings
+
+The following settings can be configured:
+
+- To change keyboard shortcuts, open the Keyboard Shortcuts settings (`Cmd/Ctrl+Shift+P` -> `Preferences: Open Keyboard Shortcuts`) and search for `qiskit-vscode`.
+
+- You can change the IBM Quantum API token to use in the VSCode command palette. To do that, type `Cmd/Ctrl+Shift+P`, search for `qiskit`, select the **Qiskit Code Assistant: Set IBM Quantum API token** command, and paste your IBM Quantum API token.
+
+- [Advanced] To change the instance of the Qiskit Code Assistant Service that the extension should use, go to File > Preferences > Settings > User Settings and edit the `Qiskit Code Assistant: Url`.
+
+## Get started using the Qiskit Code Assistant extension for VSCode
+
+
+### Authentication and setup
+
+After installing the extension, it tries to authenticate you. By default, the package tries to authenticate to IBM Quantum services with the defined Qiskit API token, and uses your token from the `QISKIT_IBM_TOKEN` environment variable or from the file `~/.qiskit/qiskit-ibm.json` (under the section `default-ibm-quantum`). If you need help configuring your account, follow the instructions in [Set up to use IBM Quantum Platform.](/guides/setup-channel#set-up-to-use-ibm-quantum-platform)
+
+By default, the extension uses the `granite-8b-qiskit` model, which is listed in the Model Picker in the bottom status bar.
+
+
+
+The first time you use the `granite-8b-qiskit` model, a modal opens listing some major restrictions that you should be aware of when using the model. Clicking `Accept` will accept the disclaimer and enable the model for code generation.
+
+
+
+### Generate Code
+After accepting the EULA, you can open a new file and start coding. To get a code suggestion, type `Ctrl` + `.` as shown:
+
+
+
+Press the `Tab` key to accept the model-generated suggestion or press the `ESC` key to reject it.
+
+
+- Type `Ctrl` + `.` again to generate additional suggestions.
+- When a suggestion is shown, you can use `Alt/Option` + `]` and `Alt/Option + `[` to cycle forward and backward, respectively, through the suggestions (if available).
+- You can hover the cursor over the suggestion to use the pop-up toolbar to cycle through the suggestions, as shown:
+ 
+
+
+## Uninstall the VSCode extension
+
+To remove the Qiskit Code Assistant from VSCode, follow these steps:
+
+1. Launch Visual Studio Code.
+1. Click the Extensions icon.
+1. Search for `qiskit-vscode`.
+1. Click **Uninstall** for the "Qiskit Code Assistant".
+
+
+## Troubleshooting
+
+If you are not seeing the extension status bar in VSCode, check that the extension is installed and enabled under the extensions tab.
+
+If the extension is installed and enabled, but cannot select a model, verify that your current API Token has been added and the `Qiskit Code Assistant: Url` is properly set.
+
+## Contribute to the VSCode extension
+
+The code for this official extension is publicly available and open source. Check it out in [github.](https://github.com/Qiskit/qiskit-code-assistant-vscode)
diff --git a/docs/guides/qiskit-code-assistant.mdx b/docs/guides/qiskit-code-assistant.mdx
new file mode 100644
index 00000000000..3dac4d3fd91
--- /dev/null
+++ b/docs/guides/qiskit-code-assistant.mdx
@@ -0,0 +1,76 @@
+---
+title: Qiskit Code Assistant
+description: Learn how to use Qiskit Code Assistant, a generative AI code assistant.
+---
+
+# Qiskit Code Assistant
+
+The Qiskit Code Assistant aims to make quantum computing more accessible to new Qiskit adopters and to improve the coding experience for current users. It is a generative AI code assistant powered by [watsonx](https://www.ibm.com/products/watsonx-ai). It is trained using millions of text tokens from Qiskit SDK v1.x, years of Qiskit code examples and IBM Quantum™ features. The Qiskit Code Assistant can help your quantum development workflow by offering LLM-generated suggestions based on [IBM Granite 8B Code,](https://www.ibm.com/products/watsonx-ai/foundation-models) which incorporate the latest features and functionalities from IBM®.
+
+
+ - This is an experimental feature available only to IBM Quantum Premium Plan users.
+ - The Qiskit Code Assistant is in preview release status and is subject to change.
+ - If you have feedback or want to contact the developer team, use the [Qiskit Slack Workspace channel](https://qiskit.enterprise.slack.com/archives/C07LYA6PL83) or the related public GitHub repositories.
+
+
+
+
+## Features
+
+The following features are included in the [Visual Studio Code](https://code.visualstudio.com/) (VSCode) and [JupyterLab.](https://jupyterlab.readthedocs.io/en/latest/) extensions:
+
+* Accelerates Qiskit code generation by leveraging generative AI based on the `granite-8b-qiskit` model.
+* Allows abstract and specific prompts to generate recommendations.
+* Presents suggestions that you can review, accept, or reject.
+* Supports Python code and Jupyter notebook files.
+* Includes guardrails to avoid answering questions that represent a potential risk for users, such as hateful speech.
+
+For instructions to integrate Qiskit Code Assistant directly into your development environment, follow the instructions in the appropriate topic:
+- [JupyterLab](/guides/qiskit-code-assistant-jupyterlab)
+- [VSCode](/guides/qiskit-code-assistant-vscode)
+
+## The Large Language Model (LLM) behind the Qiskit Code Assistant
+
+To provide code suggestions, the Qiskit Code Assistant uses a Large Language Model (LLM). In this case, the Qiskit Code Assistant relies on the model `granite-8b-qiskit`, built on the IBM [granite-8b-code model.](https://github.com/ibm-granite/granite-code-models) The `granite-8b-qiskit` model improves the `granite-8b-code` model's code generation capabilities for Qiskit through extended pretraining and fine-tuning it on high-quality Qiskit data, as well as Python commits and chat. For more information about the IBM Granite models family, refer to [Granite Code Models: A Family of Open Foundation Models for Code Intelligence.](https://arxiv.org/abs/2405.04324) For more details about the `granite-.*-qiskit` models, see [Qiskit Code Assistant: Training LLMs for generating Quantum Computing Code.](https://arxiv.org/abs/2405.19495)
+
+The model `granite-8b-qiskit` model is expected to be open source soon.
+
+## The Qiskit HumanEval benchmark
+
+To test the `granite-8b-qiskit` model, we are creating, in collaboration with Qiskit Advocates and experts, a new execution-based benchmark called Qiskit HumanEval (QHE). This benchmark is similar to [HumanEval](https://arxiv.org/abs/2107.03374), including multiple challenging code problems to solve, all based on the official Qiskit libraries.
+
+The benchmark is composed of approximately 150 tests, each one made from a function definition, followed by a docstring that details the task the model is required to solve. Each example also includes a reference canonical solution, as well as unit tests, to evaluate the correctness of the generated solutions. There are three levels of difficulty for tests: basic, intermediate, and difficult.
+
+
+The dataset for the Qiskit HumanEval is expected to be open source soon.
+
+
+## More information and citations
+
+To learn more about the Qiskit Code Assistant or the Qiskit HumanEval and cite it in your scientific publications, review these recommended citations:
+
+```
+@misc{2405.19495,
+Author = {Nicolas Dupuis and Luca Buratti and Sanjay Vishwakarma and Aitana Viudes Forrat and David Kremer and Ismael Faro and Ruchir Puri and Juan Cruz-Benito},
+Title = {Qiskit Code Assistant: Training LLMs for generating Quantum Computing Code},
+Year = {2024},
+Eprint = {arXiv:2405.19495},
+}
+```
+
+```
+@misc{2406.14712,
+Author = {Sanjay Vishwakarma and Francis Harkins and Siddharth Golecha and Vishal Sharathchandra Bajpe and Nicolas Dupuis and Luca Buratti and David Kremer and Ismael Faro and Ruchir Puri and Juan Cruz-Benito},
+Title = {Qiskit HumanEval: An Evaluation Benchmark For Quantum Code Generative Models},
+Year = {2024},
+Eprint = {arXiv:2406.14712},
+}
+```
+
+## Next steps
+
+
+ Install and use the official [JupyterLab](/guides/qiskit-code-assistant-jupyterlab) or [VSCode](/guides/qiskit-code-assistant-vscode) extensions.
+
diff --git a/public/images/guides/qiskit-code-assistant/eula.png b/public/images/guides/qiskit-code-assistant/eula.png
new file mode 100644
index 00000000000..2584d49b163
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/eula.png differ
diff --git a/public/images/guides/qiskit-code-assistant/jupyterlab-inline-complete.png b/public/images/guides/qiskit-code-assistant/jupyterlab-inline-complete.png
new file mode 100644
index 00000000000..ec245c40082
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/jupyterlab-inline-complete.png differ
diff --git a/public/images/guides/qiskit-code-assistant/jupyterlab-selected-model.png b/public/images/guides/qiskit-code-assistant/jupyterlab-selected-model.png
new file mode 100644
index 00000000000..62033ff17e9
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/jupyterlab-selected-model.png differ
diff --git a/public/images/guides/qiskit-code-assistant/jupyterlab-tab-complete.png b/public/images/guides/qiskit-code-assistant/jupyterlab-tab-complete.png
new file mode 100644
index 00000000000..f1064cc3e1e
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/jupyterlab-tab-complete.png differ
diff --git a/public/images/guides/qiskit-code-assistant/vscode-inline-suggestion-toolbar.png b/public/images/guides/qiskit-code-assistant/vscode-inline-suggestion-toolbar.png
new file mode 100644
index 00000000000..283c8acd60f
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/vscode-inline-suggestion-toolbar.png differ
diff --git a/public/images/guides/qiskit-code-assistant/vscode-inline-suggestion.png b/public/images/guides/qiskit-code-assistant/vscode-inline-suggestion.png
new file mode 100644
index 00000000000..b01bbe26eb5
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/vscode-inline-suggestion.png differ
diff --git a/public/images/guides/qiskit-code-assistant/vscode-selected-model.png b/public/images/guides/qiskit-code-assistant/vscode-selected-model.png
new file mode 100644
index 00000000000..a3f6c7eb369
Binary files /dev/null and b/public/images/guides/qiskit-code-assistant/vscode-selected-model.png differ
diff --git a/public/videos/guides/qiskit-code-assistant/demo-JupyterLab-t1t2-granite-8b-qiskit-short.mp4 b/public/videos/guides/qiskit-code-assistant/demo-JupyterLab-t1t2-granite-8b-qiskit-short.mp4
new file mode 100644
index 00000000000..37ae93153d5
Binary files /dev/null and b/public/videos/guides/qiskit-code-assistant/demo-JupyterLab-t1t2-granite-8b-qiskit-short.mp4 differ
diff --git a/public/videos/guides/qiskit-code-assistant/demo-Vscode-RandomLinearFunction_8b-qiskit.mp4 b/public/videos/guides/qiskit-code-assistant/demo-Vscode-RandomLinearFunction_8b-qiskit.mp4
new file mode 100644
index 00000000000..501b0dd3e42
Binary files /dev/null and b/public/videos/guides/qiskit-code-assistant/demo-Vscode-RandomLinearFunction_8b-qiskit.mp4 differ
diff --git a/qiskit_bot.yaml b/qiskit_bot.yaml
index 2e786df0219..d0393107b0a 100644
--- a/qiskit_bot.yaml
+++ b/qiskit_bot.yaml
@@ -139,6 +139,18 @@ notifications:
"docs/guides/processor-types":
- "`@lerongil`"
- "@abbycross"
+ "docs/guides/qiskit-code-assistant":
+ - "cbjuan"
+ - "@abbycross"
+ - "@beckykd"
+ "docs/guides/qiskit-code-assistant-jupyterlab":
+ - "cbjuan"
+ - "@abbycross"
+ - "@beckykd"
+ "docs/guides/qiskit-code-assistant-vscode":
+ - "cbjuan"
+ - "@abbycross"
+ - "@beckykd"
"docs/guides/pulse":
- "`@nkanazawa1989`"
- "@abbycross"
diff --git a/scripts/config/cspell/dictionaries/people.txt b/scripts/config/cspell/dictionaries/people.txt
index 964dcea999c..af86a90e190 100644
--- a/scripts/config/cspell/dictionaries/people.txt
+++ b/scripts/config/cspell/dictionaries/people.txt
@@ -8,7 +8,9 @@ Ambainis
Boeblingen
Bravyi
Bremner
+Bajpe
Bruhat
+Buratti
Bures
Capelluto
Chebyshev
@@ -18,11 +20,13 @@ Chuang
Cleve
Cuccaro
Dueck
+Dupuis
Easwar
Eisert
Frobenius
Gosset
Gottesman
+Golecha
Gushu
Häner
Hardamard
@@ -44,6 +48,7 @@ Kraus
Kremer
Kutin
Lauer
+Luca
Lindblad
Margolus
Martonosi
@@ -69,7 +74,9 @@ Renato
Renner
Roetteler
Rueschlikon
+Ruchir
Shaohan
+Siddharth
Shaydulin
Shende
Shor’s
@@ -83,6 +90,9 @@ Tapp
Toffoli
Uhrig
Vazirani
+Vishwakarma
+Viudes
+Vishal
Vedral
Watrous
Weyl
diff --git a/scripts/config/cspell/dictionaries/qiskit.txt b/scripts/config/cspell/dictionaries/qiskit.txt
index 189b9953f4d..725331caeb0 100644
--- a/scripts/config/cspell/dictionaries/qiskit.txt
+++ b/scripts/config/cspell/dictionaries/qiskit.txt
@@ -186,4 +186,5 @@ unitarity
unnormalized
unphysical
venv
+watsonx
xgate
diff --git a/scripts/js/commands/checkPatternsIndex.ts b/scripts/js/commands/checkPatternsIndex.ts
index 4712f67caa0..b6386074860 100644
--- a/scripts/js/commands/checkPatternsIndex.ts
+++ b/scripts/js/commands/checkPatternsIndex.ts
@@ -14,7 +14,11 @@ import { readFile } from "fs/promises";
import type { TocEntry } from "../lib/api/generateToc.js";
-const IGNORED_URLS: string[] = [];
+const IGNORED_URLS: string[] = [
+ "/guides/qiskit-code-assistant",
+ "/guides/qiskit-code-assistant-jupyterlab",
+ "/guides/qiskit-code-assistant-vscode",
+];
const INDEX_PAGES = [
"docs/guides/map-problem-to-circuits.mdx",