Skip to main content

nninteractive-client

Lightweight, torch-free remote client for nnInteractive.

Install this package if you only want to drive a remote nninteractive-server (e.g. from a GUI, a thin client, or a host with its own torch policy such as 3D Slicer). It pulls in only the wire dependencies (numpy, httpx, blosc2) — no torch, no nnU-Net.

pip install nninteractive-client
from nnInteractive.inference.remote import nnInteractiveRemoteInferenceSession
import numpy as np

session = nnInteractiveRemoteInferenceSession("http://gpu-box:1527", api_key="…")
session.set_image(image_4d)                       # numpy, [C, X, Y, Z]
session.set_target_buffer(np.zeros(image_4d.shape[1:], dtype=np.uint8))
session.add_point_interaction([60, 70, 30], include_interaction=True)

The client exposes the same public API and capability attributes as the local nnInteractiveInferenceSession, so it is a drop-in replacement. See SERVER_CLIENT.md for the full client/server guide.

Need local inference or the server?

Those live in the full package. Installing it gives you everything (it depends on this client):

pip install nnInteractive

If you try to use a full-only feature from a client-only install, you'll get a clear error pointing you here.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

nninteractive_client-2.5.1.tar.gz (25.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

nninteractive_client-2.5.1-py3-none-any.whl (25.5 kB view details)

Uploaded Python 3

File details

Details for the file nninteractive_client-2.5.1.tar.gz.

File metadata

  • Download URL: nninteractive_client-2.5.1.tar.gz
  • Upload date:
  • Size: 25.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.12

File hashes

Hashes for nninteractive_client-2.5.1.tar.gz
Algorithm Hash digest
SHA256 0a81e79187bdb64125a41c7ea3293f1159184b886aa3cebed6a8009228d33d63
MD5 5c2f930a6eb41f1e9c1da4549b288f49
BLAKE2b-256 d2b3a1c11ff8982bcc656c92a782632edb077681d7b691c0d7bca8a4ee5ecbd2

See more details on using hashes here.

Provenance

The following attestation bundles were made for nninteractive_client-2.5.1.tar.gz:

Publisher: publish.yml on MIC-DKFZ/nnInteractive

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file nninteractive_client-2.5.1-py3-none-any.whl.

File metadata

File hashes

Hashes for nninteractive_client-2.5.1-py3-none-any.whl
Algorithm Hash digest
SHA256 852cc69b30f12b04e244e7b305396c89a157631d09806d148478674898720dfc
MD5 f9b09230e6283b19ccc5948c6a869028
BLAKE2b-256 d45c28d97e7d69bba14ed82de27582a07ecedf1ae33314aa833fb32b14e1fa08

See more details on using hashes here.

Provenance

The following attestation bundles were made for nninteractive_client-2.5.1-py3-none-any.whl:

Publisher: publish.yml on MIC-DKFZ/nnInteractive

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page