qbraid-cli 0.9.5__tar.gz → 0.9.7__tar.gz

qbraid_cli-0.9.7/.github/dependabot.yml

@@ -0,0 +1,15 @@
+# To get started with Dependabot version updates, you'll need to specify which
+# package ecosystems to update and where the package manifests are located.
+# Please see the documentation for all configuration options:
+# https://docs.github.com/github/administering-a-repository/configuration-options-for-dependency-updates
+
+version: 2
+updates:
+  - package-ecosystem: "pip" # See documentation for possible values
+    directory: "/" # Location of package manifests
+    schedule:
+      interval: "weekly"
+  - package-ecosystem: "github-actions"
+    directory: "/"
+    schedule:
+      interval: "weekly"

qbraid_cli-0.9.7/.github/workflows/ci-pr-target.yml

@@ -0,0 +1,81 @@
+name: CI (PR Target)
+
+on:
+  pull_request_target:
+    branches: ['main']
+    types: [opened, reopened, ready_for_review, synchronize]
+
+jobs:
+  build:
+    if: github.event.pull_request.draft == false && github.event.pull_request.user.login == 'dependabot[bot]'
+    runs-on: ubuntu-latest
+    strategy:
+      matrix:
+        python-version: ['3.11']
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Upgrade pip and install build tools
+        run: |
+          pip install --upgrade pip
+          pip install setuptools wheel build
+      - name: Build the package
+        run: |
+          python -m build
+      - name: Upload built package
+        uses: actions/upload-artifact@v4
+        with:
+          name: built-package
+          path: dist/*.whl
+
+  test:
+    if: github.event.pull_request.draft == false && github.event.pull_request.user.login == 'dependabot[bot]'
+    needs: build
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest]
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+      fail-fast: true
+
+    steps:
+      - uses: actions/checkout@v4
+      - name: Set up Python ${{ matrix.python-version }}
+        uses: actions/setup-python@v5
+        with:
+          python-version: ${{ matrix.python-version }}
+          cache: pip
+      - name: Download built package
+        uses: actions/download-artifact@v4
+        with:
+          name: built-package
+          path: dist
+      - name: Install package
+        run: |
+          if ($env:RUNNER_OS -eq "Windows") {
+            Get-ChildItem dist/*.whl | ForEach-Object { pip install $_.FullName }
+          } else {
+            pip install dist/*.whl
+          }
+        shell: pwsh
+      - name: Install testing dependencies
+        run: |
+          pip install pytest pytest-cov qbraid-core[environments]
+      - name: Run tests with pytest
+        run: |
+          pytest --cov=qbraid_cli tests/ --cov-report=html --cov-report=xml --cov-report=term --cov-config=pyproject.toml
+        env:
+          QBRAID_API_KEY: ${{ secrets.QBRAID_API_KEY }}
+      - name: Upload coverage to Codecov
+        if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
+        uses: codecov/codecov-action@v5.1.2
+        with:
+          token: ${{ secrets.CODECOV_TOKEN }}
+          fail_ci_if_error: false
+          files: ./build/coverage/coverage.xml
+          verbose: true

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/.github/workflows/main.yml

@@ -10,7 +10,7 @@ on:
 
 jobs:
   build:
-    if: github.event.pull_request.draft == false
+    if: github.event.pull_request.draft == false && github.event.pull_request.user.login != 'dependabot[bot]'
     runs-on: ubuntu-latest
     strategy:
       matrix:
@@ -37,13 +37,14 @@ jobs:
           path: dist/*.whl
 
   test:
-    if: github.event.pull_request.draft == false
+    if: github.event.pull_request.draft == false && github.event.pull_request.user.login != 'dependabot[bot]'
     needs: build
     runs-on: ${{ matrix.os }}
     strategy:
       matrix:
         os: [ubuntu-latest, windows-latest]
-        python-version: ['3.9', '3.10', '3.11', '3.12']
+        python-version: ['3.9', '3.10', '3.11', '3.12', '3.13']
+      fail-fast: true
 
     steps:
       - uses: actions/checkout@v4
@@ -75,7 +76,7 @@ jobs:
           QBRAID_API_KEY: ${{ secrets.QBRAID_API_KEY }}
       - name: Upload coverage to Codecov
         if: matrix.python-version == '3.11' && matrix.os == 'ubuntu-latest'
-        uses: codecov/codecov-action@v4.4.1
+        uses: codecov/codecov-action@v5.1.2
         with:
           token: ${{ secrets.CODECOV_TOKEN }}
           fail_ci_if_error: false

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: qbraid-cli
-Version: 0.9.5
+Version: 0.9.7
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License: Proprietary
@@ -52,7 +52,11 @@ Requires-Dist: pytest-cov; extra == "dev"
 
 Command Line Interface for interacting with all parts of the qBraid platform.
 
-The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction with qBraid cloud services and quantum software management tools. Initially exclusive to the [qBraid Lab](https://docs.qbraid.com/lab/user-guide/overview) platform, the CLI now supports local installations as well. This enhancement broadens access to features like [qBraid Quantum Jobs](https://docs.qbraid.com/cli/user-guide/quantum-jobs), enabling direct acess to QPU devices from leading providers like IonQ, Oxford Quantum Circuits, QuEra, Rigetti, and IQM, as well as on-demand simulators from qBraid and AWS, all using qBraid [credits](https://docs.qbraid.com/home/pricing), with no additional access keys required.
+The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction with qBraid cloud services and quantum software management tools. Initially exclusive to the [qBraid Lab](https://docs.qbraid.com/lab/user-guide/overview) platform, the CLI now supports local installations as well. This enhancement broadens access to features like [qBraid Quantum Jobs](https://docs.qbraid.com/cli/user-guide/quantum-jobs), enabling direct, pre-configured access to QPUs from IonQ, Oxford Quantum Circuits, QuEra, Rigetti, and IQM, as well as on-demand simulators from qBraid, AWS, IonQ, QuEra, and NEC. See [pricing](https://docs.qbraid.com/home/pricing) for more.
+
+*Resources*:
+- [User Guide](https://docs.qbraid.com/cli/user-guide/overview)
+- [API Reference](https://docs.qbraid.com/cli/api-reference/qbraid)
 
 ## Getting Started
 
@@ -69,6 +73,12 @@ You can also install the qBraid-CLI from PyPI with:
 pip install qbraid-cli
 ```
 
+To manage qBraid [environments](https://docs.qbraid.com/lab/user-guide/environments) using the CLI, you must also install the `envs` extra:
+
+```bash
+pip install 'qbraid-cli[envs]'
+```
+
 ## Local configuration
 
 After installation, you must configure your account credentials to use the CLI locally:
@@ -83,6 +93,8 @@ After installation, you must configure your account credentials to use the CLI l
 $ qbraid configure
 ```
 
+For more on API keys, see [documentation](https://docs.qbraid.com/home/account#api-keys).
+
 ## Basic Commands
 
 ```bash
@@ -142,12 +154,17 @@ Options
   --help                        Show this message and exit.
 
 Commands
+  account                       Manage qBraid account
+  admin                         CI/CD commands for qBraid maintainers.
   configure                     Configure qBraid CLI options.
   account                       Manage qBraid account.
+  chat                          Interact with qBraid AI chat service.
   devices                       Manage qBraid quantum devices.
   envs                          Manage qBraid environments.
+  files                         Manage qBraid cloud storage files.
   jobs                          Manage qBraid quantum jobs.
   kernels                       Manage qBraid kernels.
+  pip                           Run pip command in active qBraid environment.
 ```
 
 To get the version of the qBraid CLI:
@@ -173,7 +190,5 @@ In [1]: %load_ext qbraid_magic
 Now you can continue to use the qBraid-CLI as normal from within your Jupyter notebook using the magic ``%`` operator, e.g.
 
 ```python
-In [2]: %qbraid jobs state
-
-In [3]: %qbraid jobs enable braket -y
+In [2]: %qbraid chat -f code -p "Write a Qiskit bell circuit"
 ```

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/README.md

@@ -9,7 +9,11 @@
 
 Command Line Interface for interacting with all parts of the qBraid platform.
 
-The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction with qBraid cloud services and quantum software management tools. Initially exclusive to the [qBraid Lab](https://docs.qbraid.com/lab/user-guide/overview) platform, the CLI now supports local installations as well. This enhancement broadens access to features like [qBraid Quantum Jobs](https://docs.qbraid.com/cli/user-guide/quantum-jobs), enabling direct acess to QPU devices from leading providers like IonQ, Oxford Quantum Circuits, QuEra, Rigetti, and IQM, as well as on-demand simulators from qBraid and AWS, all using qBraid [credits](https://docs.qbraid.com/home/pricing), with no additional access keys required.
+The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction with qBraid cloud services and quantum software management tools. Initially exclusive to the [qBraid Lab](https://docs.qbraid.com/lab/user-guide/overview) platform, the CLI now supports local installations as well. This enhancement broadens access to features like [qBraid Quantum Jobs](https://docs.qbraid.com/cli/user-guide/quantum-jobs), enabling direct, pre-configured access to QPUs from IonQ, Oxford Quantum Circuits, QuEra, Rigetti, and IQM, as well as on-demand simulators from qBraid, AWS, IonQ, QuEra, and NEC. See [pricing](https://docs.qbraid.com/home/pricing) for more.
+
+*Resources*:
+- [User Guide](https://docs.qbraid.com/cli/user-guide/overview)
+- [API Reference](https://docs.qbraid.com/cli/api-reference/qbraid)
 
 ## Getting Started
 
@@ -26,6 +30,12 @@ You can also install the qBraid-CLI from PyPI with:
 pip install qbraid-cli
 ```
 
+To manage qBraid [environments](https://docs.qbraid.com/lab/user-guide/environments) using the CLI, you must also install the `envs` extra:
+
+```bash
+pip install 'qbraid-cli[envs]'
+```
+
 ## Local configuration
 
 After installation, you must configure your account credentials to use the CLI locally:
@@ -40,6 +50,8 @@ After installation, you must configure your account credentials to use the CLI l
 $ qbraid configure
 ```
 
+For more on API keys, see [documentation](https://docs.qbraid.com/home/account#api-keys).
+
 ## Basic Commands
 
 ```bash
@@ -99,12 +111,17 @@ Options
   --help                        Show this message and exit.
 
 Commands
+  account                       Manage qBraid account
+  admin                         CI/CD commands for qBraid maintainers.
   configure                     Configure qBraid CLI options.
   account                       Manage qBraid account.
+  chat                          Interact with qBraid AI chat service.
   devices                       Manage qBraid quantum devices.
   envs                          Manage qBraid environments.
+  files                         Manage qBraid cloud storage files.
   jobs                          Manage qBraid quantum jobs.
   kernels                       Manage qBraid kernels.
+  pip                           Run pip command in active qBraid environment.
 ```
 
 To get the version of the qBraid CLI:
@@ -130,7 +147,5 @@ In [1]: %load_ext qbraid_magic
 Now you can continue to use the qBraid-CLI as normal from within your Jupyter notebook using the magic ``%`` operator, e.g.
 
 ```python
-In [2]: %qbraid jobs state
-
-In [3]: %qbraid jobs enable braket -y
+In [2]: %qbraid chat -f code -p "Write a Qiskit bell circuit"
 ```

qbraid_cli-0.9.7/docs/requirements.txt

@@ -0,0 +1,7 @@
+sphinx>=7.2.6,<8.2.0
+sphinx-rtd-theme>=1.3,<3.1
+docutils<0.22
+toml
+build
+m2r
+typer

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "qbraid-cli"
-version = "0.9.5"
+version = "0.9.7"
 description = "Command Line Interface for interacting with all parts of the qBraid platform."
 readme = "README.md"
 authors = [{ name = "qBraid Development Team", email = "contact@qbraid.com" }]

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli/_version.py

@@ -12,5 +12,5 @@ __version__: str
 __version_tuple__: VERSION_TUPLE
 version_tuple: VERSION_TUPLE
 
-__version__ = version = '0.1.dev1+g5dbdf17'
-__version_tuple__ = version_tuple = (0, 1, 'dev1', 'g5dbdf17')
+__version__ = version = '0.1.dev1+g51fd097'
+__version_tuple__ = version_tuple = (0, 1, 'dev1', 'g51fd097')

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli/admin/app.py

@@ -10,8 +10,8 @@ from typing import Optional
 
 import typer
 
-from qbraid_cli.admin.headers import check_and_fix_headers
-from qbraid_cli.admin.validation import validate_header_type, validate_paths_exist
+from qbraid_cli.admin.headers import HeaderType, check_and_fix_headers
+from qbraid_cli.admin.validation import validate_paths_exist
 
 admin_app = typer.Typer(
     help="CI/CD commands for qBraid maintainers.",
@@ -25,12 +25,8 @@ def admin_headers(
     src_paths: list[str] = typer.Argument(
         ..., help="Source file or directory paths to verify.", callback=validate_paths_exist
     ),
-    header_type: str = typer.Option(
-        "default",
-        "--type",
-        "-t",
-        help="Type of header to use ('default' or 'gpl').",
-        callback=validate_header_type,
+    header_type: HeaderType = typer.Option(
+        "default", "--type", "-t", help="Type of header to use."
     ),
     skip_files: list[str] = typer.Option(
         [], "--skip", "-s", help="Files to skip during verification.", callback=validate_paths_exist

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli/admin/headers.py

@@ -1,6 +1,8 @@
 # Copyright (c) 2024, qBraid Development Team
 # All rights reserved.
 
+# pylint: disable=too-many-branches,too-many-statements
+
 """
 Script to verify qBraid copyright file headers
 
@@ -8,6 +10,8 @@ Script to verify qBraid copyright file headers
 
 import datetime
 import os
+from enum import Enum
+from pathlib import Path
 from typing import Optional
 
 import typer
@@ -15,36 +19,47 @@ from rich.console import Console
 
 from qbraid_cli.handlers import handle_error
 
-# pylint: disable=too-many-branches,too-many-statements
 CURR_YEAR = datetime.datetime.now().year
 PREV_YEAR = CURR_YEAR - 1
-VALID_EXTS = (".py", ".js", ".ts")
 
+COMMENT_MARKER = {
+    ".py": "#",
+    ".js": "//",
+    ".ts": "//",
+}
+
+VALID_EXTS = tuple(COMMENT_MARKER.keys())
+
+
+class HeaderType(Enum):
+    """Type of header to use."""
+
+    default = "default"  # pylint: disable=invalid-name
+    gpl = "gpl"  # pylint: disable=invalid-name
 
-DEFAULT_HEADER = f"""# Copyright (c) {str(CURR_YEAR)}, qBraid Development Team
+
+DEFAULT_HEADER = f"""# Copyright (c) {CURR_YEAR}, qBraid Development Team
 # All rights reserved.
 """
 
-DEFAULT_HEADER_GPL = (
-    f"""# Copyright (C) {str(CURR_YEAR)} qBraid"""
-    + """#
-# This file is part of {project_name}
+DEFAULT_HEADER_GPL = f"""# Copyright (C) {CURR_YEAR} qBraid
+#
+# This file is part of {{project_name}}
 #
-# {project_name_start} is free software released under the GNU General Public License v3
+# {{project_name_start}} is free software released under the GNU General Public License v3
 # or later. You can redistribute and/or modify it under the terms of the GPL v3.
 # See the LICENSE file in the project root or <https://www.gnu.org/licenses/gpl-3.0.html>.
 #
-# THERE IS NO WARRANTY for {project_name}, as per Section 15 of the GPL v3.
+# THERE IS NO WARRANTY for {{project_name}}, as per Section 15 of the GPL v3.
 """
-)
 
 HEADER_TYPES = {
-    "default": DEFAULT_HEADER,
-    "gpl": DEFAULT_HEADER_GPL,
+    HeaderType.default: DEFAULT_HEADER,
+    HeaderType.gpl: DEFAULT_HEADER_GPL,
 }
 
 
-def get_formatted_header(header_type: str, project_name: str) -> str:
+def get_formatted_header(header_type: HeaderType, project_name: str) -> str:
     """Get the formatted header based on the header type
 
     Args:
@@ -56,16 +71,24 @@ def get_formatted_header(header_type: str, project_name: str) -> str:
     """
 
     header = HEADER_TYPES[header_type]
-    if header_type == "gpl":
-        return header.format(
-            project_name=project_name, project_name_start=project_name[0].upper() + project_name[1:]
-        )
+    if header_type == HeaderType.gpl:
+        if project_name.split(" ")[0].lower() == "the":
+            project_name = project_name[:1].lower() + project_name[1:]
+            project_name_start = project_name[:1].upper() + project_name[1:]
+        else:
+            project_name_start = project_name
+        return header.format(project_name=project_name, project_name_start=project_name_start)
     return header
 
 
+def _get_comment_marker(file_path: str, default: Optional[str] = None) -> str:
+    file_ext = Path(file_path).suffix
+    return COMMENT_MARKER.get(file_ext, default)
+
+
 def check_and_fix_headers(
     src_paths: list[str],
-    header_type: str = "default",
+    header_type: HeaderType = HeaderType.default,
     skip_files: Optional[list[str]] = None,
     fix: bool = False,
     project_name: Optional[str] = None,
@@ -74,11 +97,10 @@ def check_and_fix_headers(
     try:
         header = get_formatted_header(header_type, project_name)
     except KeyError:
+        members = HeaderType._member_names_  # pylint: disable=no-member,protected-access
         handle_error(
             error_type="ValueError",
-            message=(
-                f"Invalid header type: {HEADER_TYPES}. Expected one of {list(HEADER_TYPES.keys())}"
-            ),
+            message=(f"Invalid header type: {HEADER_TYPES}. Expected one of {members}"),
         )
 
     for path in src_paths:
@@ -101,7 +123,8 @@ def check_and_fix_headers(
         if os.path.basename(file_path) == "__init__.py":
             return not content.strip()
 
-        skip_header_tag = "# qbraid: skip-header"
+        comment_marker = _get_comment_marker(file_path)
+        skip_header_tag = f"{comment_marker} qbraid: skip-header"
         line_number = 0
 
         for line in content.splitlines():
@@ -117,13 +140,7 @@ def check_and_fix_headers(
         with open(file_path, "r", encoding="ISO-8859-1") as f:
             content = f.read()
 
-        # Get the file extension
-        file_ext = os.path.splitext(file_path)[1]
-
-        if file_ext == ".py":
-            comment_marker = "#"
-        elif file_ext in (".js", ".ts"):
-            comment_marker = "//"
+        comment_marker = _get_comment_marker(file_path)
 
         # This finds the start of the actual content after skipping initial whitespace and comments.
         lines = content.splitlines()

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli/admin/validation.py

@@ -10,14 +10,7 @@ import os
 
 import typer
 
-from qbraid_cli.admin.headers import HEADER_TYPES
-from qbraid_cli.handlers import _format_list_items, validate_item
-
-
-def validate_header_type(value: str) -> str:
-    """Validate header type."""
-    header_types = list(HEADER_TYPES.keys())
-    return validate_item(value, header_types, "Header type")
+from qbraid_cli.handlers import _format_list_items
 
 
 def validate_paths_exist(paths: list[str]) -> list[str]:

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli/configure/app.py

@@ -1,4 +1,4 @@
-# Copyright (c) 2024, qBraid Development Team
+# Copyright (c) 2025, qBraid Development Team
 # All rights reserved.
 
 """
@@ -7,7 +7,9 @@ Module defining commands in the 'qbraid configure' namespace.
 """
 
 import typer
+from rich import box
 from rich.console import Console
+from rich.table import Table
 
 from qbraid_cli.configure.actions import default_action
 
@@ -36,7 +38,7 @@ def configure(ctx: typer.Context):
 def configure_set(
     name: str = typer.Argument(..., help="Config name"),
     value: str = typer.Argument(..., help="Config value"),
-    profile: str = typer.Option("default", help="Profile name"),
+    profile: str = typer.Option("default", "--profile", "-p", help="Profile name"),
 ):
     """Set configuration value in qbraidrc file."""
     # pylint: disable-next=import-outside-toplevel
@@ -53,6 +55,62 @@ def configure_set(
     typer.echo("Configuration updated successfully.")
 
 
+@configure_app.command(name="get")
+def configure_get(
+    name: str = typer.Argument(..., help="Config name"),
+    profile: str = typer.Option("default", "--profile", "-p", help="Profile name"),
+):
+    """Get configuration value from qbraidrc file."""
+    # pylint: disable-next=import-outside-toplevel
+    from qbraid_core.config import load_config
+
+    config = load_config()
+
+    if profile not in config:
+        typer.echo(f"Profile '{profile}' not found in configuration.")
+        raise typer.Exit(1)
+
+    if name not in config[profile]:
+        typer.echo(f"Configuration '{name}' not found in profile '{profile}'.")
+        raise typer.Exit(1)
+
+    typer.echo(config[profile][name])
+
+
+@configure_app.command(name="list")
+def configure_list():
+    """List all configuration values in qbraidrc."""
+    # pylint: disable-next=import-outside-toplevel
+    from qbraid_core.config import load_config
+
+    config = load_config()
+    console = Console()
+    profile = "default"
+
+    if profile not in config:
+        typer.echo("Default profile not found in configuration.")
+        raise typer.Exit(1)
+
+    if not config[profile]:
+        typer.echo("No configuration values found in default profile.")
+        return
+
+    table = Table(show_edge=False, box=box.MINIMAL)
+    table.add_column("Name", style="cyan")
+    table.add_column("Value", style="green")
+
+    sensitive_keys = {"api-key", "refresh-token"}
+
+    for name, value in config[profile].items():
+        if name in sensitive_keys and value:
+            masked_value = f"*****{str(value)[-3:]}"
+        else:
+            masked_value = str(value)
+        table.add_row(name, masked_value)
+
+    console.print(table)
+
+
 @configure_app.command(name="magic")
 def configure_magic():
     """Enable qBraid IPython magic commands."""

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.2
 Name: qbraid-cli
-Version: 0.9.5
+Version: 0.9.7
 Summary: Command Line Interface for interacting with all parts of the qBraid platform.
 Author-email: qBraid Development Team <contact@qbraid.com>
 License: Proprietary
@@ -52,7 +52,11 @@ Requires-Dist: pytest-cov; extra == "dev"
 
 Command Line Interface for interacting with all parts of the qBraid platform.
 
-The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction with qBraid cloud services and quantum software management tools. Initially exclusive to the [qBraid Lab](https://docs.qbraid.com/lab/user-guide/overview) platform, the CLI now supports local installations as well. This enhancement broadens access to features like [qBraid Quantum Jobs](https://docs.qbraid.com/cli/user-guide/quantum-jobs), enabling direct acess to QPU devices from leading providers like IonQ, Oxford Quantum Circuits, QuEra, Rigetti, and IQM, as well as on-demand simulators from qBraid and AWS, all using qBraid [credits](https://docs.qbraid.com/home/pricing), with no additional access keys required.
+The **qBraid CLI** is a versatile command-line interface tool designed for seamless interaction with qBraid cloud services and quantum software management tools. Initially exclusive to the [qBraid Lab](https://docs.qbraid.com/lab/user-guide/overview) platform, the CLI now supports local installations as well. This enhancement broadens access to features like [qBraid Quantum Jobs](https://docs.qbraid.com/cli/user-guide/quantum-jobs), enabling direct, pre-configured access to QPUs from IonQ, Oxford Quantum Circuits, QuEra, Rigetti, and IQM, as well as on-demand simulators from qBraid, AWS, IonQ, QuEra, and NEC. See [pricing](https://docs.qbraid.com/home/pricing) for more.
+
+*Resources*:
+- [User Guide](https://docs.qbraid.com/cli/user-guide/overview)
+- [API Reference](https://docs.qbraid.com/cli/api-reference/qbraid)
 
 ## Getting Started
 
@@ -69,6 +73,12 @@ You can also install the qBraid-CLI from PyPI with:
 pip install qbraid-cli
 ```
 
+To manage qBraid [environments](https://docs.qbraid.com/lab/user-guide/environments) using the CLI, you must also install the `envs` extra:
+
+```bash
+pip install 'qbraid-cli[envs]'
+```
+
 ## Local configuration
 
 After installation, you must configure your account credentials to use the CLI locally:
@@ -83,6 +93,8 @@ After installation, you must configure your account credentials to use the CLI l
 $ qbraid configure
 ```
 
+For more on API keys, see [documentation](https://docs.qbraid.com/home/account#api-keys).
+
 ## Basic Commands
 
 ```bash
@@ -142,12 +154,17 @@ Options
   --help                        Show this message and exit.
 
 Commands
+  account                       Manage qBraid account
+  admin                         CI/CD commands for qBraid maintainers.
   configure                     Configure qBraid CLI options.
   account                       Manage qBraid account.
+  chat                          Interact with qBraid AI chat service.
   devices                       Manage qBraid quantum devices.
   envs                          Manage qBraid environments.
+  files                         Manage qBraid cloud storage files.
   jobs                          Manage qBraid quantum jobs.
   kernels                       Manage qBraid kernels.
+  pip                           Run pip command in active qBraid environment.
 ```
 
 To get the version of the qBraid CLI:
@@ -173,7 +190,5 @@ In [1]: %load_ext qbraid_magic
 Now you can continue to use the qBraid-CLI as normal from within your Jupyter notebook using the magic ``%`` operator, e.g.
 
 ```python
-In [2]: %qbraid jobs state
-
-In [3]: %qbraid jobs enable braket -y
+In [2]: %qbraid chat -f code -p "Write a Qiskit bell circuit"
 ```

{qbraid_cli-0.9.5 → qbraid_cli-0.9.7}/qbraid_cli.egg-info/SOURCES.txt

@@ -8,9 +8,11 @@ Makefile
 README.md
 pyproject.toml
 .github/PULL_REQUEST_TEMPLATE.md
+.github/dependabot.yml
 .github/ISSUE_TEMPLATE/bug_report.yml
 .github/ISSUE_TEMPLATE/feature_request.yml
 .github/workflows/bump-version.yml
+.github/workflows/ci-pr-target.yml
 .github/workflows/docs-pr.yml
 .github/workflows/docs.yml
 .github/workflows/format.yml
@@ -75,6 +77,7 @@ tests/account/__init__.py
 tests/account/test_account_credits.py
 tests/admin/test_headers.py
 tests/configure/__init__.py
+tests/configure/test_configure_commands.py
 tests/configure/test_configure_prompt_for_config.py
 tests/configure/test_configure_set.py
 tests/configure/test_configure_validate_input.py