[SUPPORT] - Failed to import in latest python 3.14

[ruiyang2015]

Are you using paramiko as a client or server?

Client

What feature(s) aren't working right?

Something else

What version(s) of paramiko are you using?

4.0.0

What version(s) of Python are you using?

3.14

What operating system and version are you using?

MacOS

If you're connecting as a client, which SSH server are you connecting to?

SFTP

If you're using paramiko as part of another tool, which tool/version?

No response

What are you trying to do with paramiko?

when import paramiko in python 3.14, getting following import error:

Traceback (most recent call last):
  File "<python-input-0>", line 1, in <module>
    import paramiko
  File "/Users/ruiyang/Go/src/github.com/ascend-io/ascend-core/.venv/lib/python3.14/site-packages/paramiko/__init__.py", line 24, in <module>
    from paramiko.transport import (
    ...<3 lines>...
    )
  File "/Users/ruiyang/Go/src/github.com/ascend-io/ascend-core/.venv/lib/python3.14/site-packages/paramiko/transport.py", line 98, in <module>
    from paramiko.ed25519key import Ed25519Key
  File "/Users/ruiyang/Go/src/github.com/ascend-io/ascend-core/.venv/lib/python3.14/site-packages/paramiko/ed25519key.py", line 22, in <module>
    import nacl.signing
  File "/Users/ruiyang/Go/src/github.com/ascend-io/ascend-core/.venv/lib/python3.14/site-packages/nacl/signing.py", line 16, in <module>
    import nacl.bindings
  File "/Users/ruiyang/Go/src/github.com/ascend-io/ascend-core/.venv/lib/python3.14/site-packages/nacl/bindings/__init__.py", line 186, in <module>
    from nacl.bindings.crypto_secretstream import (
    ...<15 lines>...
    )
  File "/Users/ruiyang/Go/src/github.com/ascend-io/ascend-core/.venv/lib/python3.14/site-packages/nacl/bindings/crypto_secretstream.py", line 14, in <module>
    from typing import ByteString, Optional, Tuple, cast
ImportError: cannot import name 'ByteString' from 'typing' (/Users/ruiyang/.local/share/uv/python/cpython-3.14.0b1-macos-aarch64-none/lib/python3.14/typing.py)

How are you trying to do it, and what's happening instead?

i am trying to upgrade to latest stable python release 3.14 and facing import error for the paramiko package

Anything else?

No response

[bskinn]

This is an issue in the pynacl dependency which appears to have been fixed: pyca/pynacl#848.

paramiko does not place an upper limit on the pynacl version, so there should be no compatibility issues.

Perhaps try updating pynacl in your working environment?

[thromer]

Changing pynacl to 1.6.0 works for me for a unrelated (I presume) issue, below. In general wouldn't it be better for paramiko to change the minimum version of pynacl to 1.6.0, since consumers of paramiko shouldn't know about transitive dependencies?

FWIW in my case on debian bookworm + x86_64 with pynacl 1.5.0 I get the following error (which I can work around by installing libffi-dev):

      src/c/_cffi_backend.c:15:10: fatal error: ffi.h: No such file or directory
         15 | #include <ffi.h>
            |          ^~~~~~~
      compilation terminated.
      error: command '/usr/bin/cc' failed with exit code 1

      hint: This error likely indicates that you need to install a library that provides "ffi.h" for `cffi@1.17.1`
  help: `cffi` (v1.17.1) was included because `lsp-bridge` (v0.1.0) depends on `paramiko` (v3.5.1) which depends on `pynacl` (v1.5.0) which
        depends on `cffi`