[connectedk8s] ModuleNotFoundError: No module named 'rpds.rpds'

Source: https://github.com/Azure/azure-cli/issues/32709 (by @koepalex)
Affected extension: `connectedk8s` (`src/connectedk8s/`)

---

<<>>
# Issue #32709 (by @koepalex)
## Title
ModuleNotFoundError: No module named 'rpds.rpds'

## Body
### Describe the bug

After upgrading az cli and connectedk8s to latest version I'm not longer able to connect neu Kubernetes cluster to Azure ARC

### Related command

az connectedk8s connect --name --resource-group

### Errors

The command failed with an unexpected error. Here is the traceback:
No module named 'rpds.rpds'
Traceback (most recent call last):
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/cli.py", line 233, in invoke
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 566, in execute
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/__init__.py", line 558, in load_arguments
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 321, in load_arguments
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/commands.py", line 104, in load_arguments
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 124, in arguments_loader
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 59, in get_op_handler
File "importlib\__init__.py", line 88, in import_module
File "", line 1387, in _gcd_import
File "", line 1360, in _find_and_load
File "", line 1331, in _find_and_load_unlocked
File "", line 935, in _load_unlocked
File "", line 1027, in exec_module
File "", line 488, in _call_with_frames_removed
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\azext_connectedk8s\custom.py", line 24, in
import oras.client # type: ignore[import-untyped]
^^^^^^^^^^^^^^^^^^
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\oras\client.py", line 7, in
from .provider import Registry as OrasClient # noqa
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\oras\provider.py", line 15, in
import jsonschema
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\jsonschema\__init__.py", line 13, in
from jsonschema._format import FormatChecker
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\jsonschema\_format.py", line 11, in
from jsonschema.exceptions import FormatError
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\jsonschema\exceptions.py", line 15, in
from referencing.exceptions import Unresolvable as _Unresolvable
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\referencing\__init__.py", line 5, in
from referencing._core import Anchor, Registry, Resource, Specification
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\referencing\_core.py", line 9, in
from rpds import HashTrieMap, HashTrieSet, List
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\rpds\__init__.py", line 1, in
from .rpds import *
ModuleNotFoundError: No module named 'rpds.rpds'

### Issue script & Debug output

cli.knack.cli: Command arguments: ['connectedk8s', 'connect', '--name', 'golden-path-reference', '--resource-group', 'rg-AlexK-GP', '--debug']
cli.knack.cli: __init__ debug log:
Enable color in terminal.
cli.knack.cli: Event: Cli.PreExecute []
cli.knack.cli: Event: CommandParser.OnGlobalArgumentsCreate [, , ]
cli.knack.cli: Event: CommandInvoker.OnPreCommandTableCreate []
cli.azure.cli.core: Modules found from index for 'connectedk8s': ['azext_connectedk8s']
cli.azure.cli.core: Loading command modules:
cli.azure.cli.core: Name Load Time Groups Commands
cli.azure.cli.core: Total (0) 0.000 0 0
cli.azure.cli.core: These extensions are not installed and will be skipped: ['azext_ai_examples', 'azext_next']
cli.azure.cli.core: Loading extensions:
cli.azure.cli.core: Name Load Time Groups Commands Directory
cli.azure.cli.core: connectedk8s 0.669 1 10 C:\Users\alkopke\.azure\cliextensions\connectedk8s
cli.azure.cli.core: Total (1) 0.669 1 10
cli.azure.cli.core: Loaded 1 groups, 10 commands.
cli.azure.cli.core: Found a match in the command table.
cli.azure.cli.core: Raw command : connectedk8s connect
cli.azure.cli.core: Command table: connectedk8s connect
cli.knack.cli: Event: CommandInvoker.OnPreCommandTableTruncate []
cli.azure.cli.core.azlogging: metadata file logging enabled - writing logs to 'C:\Users\alkopke\.azure\commands\2026-01-27.14-24-48.connectedk8s_connect.35632.log'.
az_command_data_logger: command args: connectedk8s connect --name {} --resource-group {} --debug
cli.knack.cli: Event: CommandInvoker.OnPreArgumentLoad [.add_subscription_parameter at 0x00000165D7AE68E0>]
cli.azure.cli.core.azclierror: Traceback (most recent call last):
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/cli.py", line 233, in invoke
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 566, in execute
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/__init__.py", line 558, in load_arguments
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/__init__.py", line 321, in load_arguments
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\knack/commands.py", line 104, in load_arguments
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 124, in arguments_loader
File "D:\a\_work\1\s\build_scripts\windows\artifacts\cli\Lib\site-packages\azure/cli/core/commands/command_operation.py", line 59, in get_op_handler
File "importlib\__init__.py", line 88, in import_module
File "", line 1387, in _gcd_import
File "", line 1360, in _find_and_load
File "", line 1331, in _find_and_load_unlocked
File "", line 935, in _load_unlocked
File "", line 1027, in exec_module
File "", line 488, in _call_with_frames_removed
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\azext_connectedk8s\custom.py", line 24, in
import oras.client # type: ignore[import-untyped]
^^^^^^^^^^^^^^^^^^
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\oras\client.py", line 7, in
from .provider import Registry as OrasClient # noqa
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\oras\provider.py", line 15, in
import jsonschema
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\jsonschema\__init__.py", line 13, in
from jsonschema._format import FormatChecker
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\jsonschema\_format.py", line 11, in
from jsonschema.exceptions import FormatError
File "C:\Users\alkopke\.azure\cliextensions\connectedk8s\jsonschema\exceptions.py", line 15, in
from referencing.exceptions import Unresolvable as _Unresolvable
File "C:\Users\alkopke\.azure\cliextensions\connect
... [truncated, original was 16238 chars]

## Comments
### Comment by @yonzhan

Thank you for opening this issue, we will look into it.

### Comment by @github-actions[bot]
Here are some similar issues that might help you. Please check if they can solve your problem.
- #29938
- #31408
- #11997
------------

**Possible solution (Extracted from existing issue, might be incorrect; please verify carefully)**

### Solution 1:
Reinstalling the extension via `az extension remove -n ssh && az extension add -n ssh` fixed it for me.

**Reference**:
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2454959710
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2556412549
- https://github.com/azure/azure-cli/issues/29938#issuecomment-3244900660
### Solution 2:
Faced this today and just did a simple extension update to fix it, no removing needed:

'''
az extension update --name ssh
'''

**Reference**:
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2528561080
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2544828565
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2557204128
### Solution 3:
I manually installed the missing module in the az venv which did the trick for me:

'''
$(brew --cellar az)/2.66.0/libexec/bin/pip install rpds-py
'''

**Reference**:
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2472890936
- https://github.com/azure/azure-cli/issues/29938#issuecomment-2734094129

_Powered by [issue-sentinel](https://github.com/Azure/issue-Sentinel)_

### Comment by @koepalex
tried
''' pwsh
pushd "C:\Program Files\Microsoft SDKs\Azure\CLI2\"
.\python.exe -m pip install rpds-py
'''

Output
> Defaulting to user installation because normal site-packages is not writeable
Collecting rpds-py
Downloading rpds_py-0.30.0-cp313-cp313-win_amd64.whl.metadata (4.2 kB)
Downloading rpds_py-0.30.0-cp313-cp313-win_amd64.whl (240 kB)
Installing collected packages: rpds-py
Successfully installed rpds-py-0.30.0

Error still persists

### Comment by @Xplz3d
HI ! i'm facing the same issue after trying all of the suggested fixes :(

### Comment by @milosbithawk
i have the same issue. tried all suggested fixes.. what helped was:
az extension remove --name ssh (restart-powershell)
az extension add --name ssh

### Comment by @Xplz3d
@milosbithawk you're lucky, i tried your fix but it doesn't works for me.
'''
az --version
azure-cli 2.83.0

core 2.83.0
telemetry 1.1.0

Extensions:
aksarc 1.5.74
connectedk8s 1.11.0
customlocation 0.1.4
k8s-extension 1.7.0
ssh 2.0.6
stack-hci-vm 1.11.9

Dependencies:
msal 1.35.0b1
azure-mgmt-resource 23.3.0

Python location 'C:\Program Files\Microsoft SDKs\Azure\CLI2\python.exe'
Config directory 'C:\Users\zopl\.azure'
Extensions directory 'C:\Users\zopl\.azure\cliextensions'

Python (Windows) 3.13.11 (tags/v3.13.11:6278944, Dec 5 2025, 16:26:58) [MSC v.1944 64 bit (AMD64)]
'''

Also tried downgrade to az cli 2.80.0 nothing changes.

### Comment by @priyansh17
Hi team, is there any update on the fix for this?
<<>>