add a scriptlet to put cuopt_grpc_server on the default path

cpp/CMakeLists.txt

@@ -799,12 +799,15 @@ if (NOT SKIP_GRPC_BUILD)
             CXX_STANDARD 20
             CXX_STANDARD_REQUIRED ON
             CXX_SCAN_FOR_MODULES OFF
+            POSITION_INDEPENDENT_CODE ON
     )
 
     target_compile_options(cuopt_grpc_server
             PRIVATE "$<$<COMPILE_LANGUAGE:CXX>:${CUOPT_CXX_FLAGS}>"
     )
 
+    target_link_options(cuopt_grpc_server PRIVATE -pie)
+
     target_include_directories(cuopt_grpc_server
             PRIVATE
             "${CMAKE_CURRENT_SOURCE_DIR}/src"

python/cuopt/cuopt/tests/linear_programming/test_cpu_only_execution.py

@@ -438,6 +438,12 @@ def _start_grpc_server_fixture(port_offset):
         stdout=subprocess.DEVNULL,
         stderr=subprocess.DEVNULL,
     )
+    time.sleep(0.5)
+    if proc.poll() is not None:
+        pytest.skip(
+            f"cuopt_grpc_server exited immediately (rc={proc.returncode}), "
+            "binary may be unable to load shared libraries in this environment"
+        )
     if not _wait_for_port(port, timeout=15):
         proc.kill()
         proc.wait()

python/cuopt_server/cuopt_server/tests/test_grpc_server_entry_point.py

@@ -0,0 +1,52 @@
+# SPDX-FileCopyrightText: Copyright (c) 2025-2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import ctypes
+import ctypes.util
+import platform
+import shutil
+import subprocess
+
+import pytest
+
+
+def test_cuopt_grpc_server_on_path():
+    assert shutil.which("cuopt_grpc_server") is not None, (
+        "cuopt_grpc_server should be on PATH after installing cuopt-server"
+    )
+
+
+def _check_libuuid():
+    """Return (found: bool, detail: str) for libuuid availability."""
+    name = ctypes.util.find_library("uuid")
+    if name is None:
+        return False, "ctypes.util.find_library('uuid') returned None"
+    try:
+        ctypes.CDLL(name)
+        return True, f"loaded {name}"
+    except OSError as exc:
+        return False, f"find_library returned '{name}' but load failed: {exc}"
+
+
+def test_cuopt_grpc_server_help():
+    result = subprocess.run(
+        ["cuopt_grpc_server", "--help"],
+        capture_output=True,
+        text=True,
+        timeout=10,
+    )
+    if result.returncode != 0 and not result.stdout and not result.stderr:
+        uuid_ok, uuid_detail = _check_libuuid()
+        pytest.skip(
+            f"cuopt_grpc_server binary failed to load "
+            f"(rc={result.returncode}, arch={platform.machine()}). "
+            f"libuuid: {uuid_detail}"
+        )
+    assert result.returncode == 0, (
+        f"cuopt_grpc_server --help failed (rc={result.returncode}): "
+        f"{result.stdout}\n{result.stderr}"
+    )
+    output = f"{result.stdout}\n{result.stderr}"
+    assert "cuopt_grpc_server" in output, (
+        f"Expected 'cuopt_grpc_server' in --help output, got: {output}"
+    )

python/libcuopt/libcuopt/_grpc_server_wrapper.py

@@ -0,0 +1,16 @@
+# SPDX-FileCopyrightText: Copyright (c) 2026, NVIDIA CORPORATION & AFFILIATES. All rights reserved.
+# SPDX-License-Identifier: Apache-2.0
+
+import os
+import subprocess
+import sys
+
+
+def main():
+    """
+    This connects to the gRPC server binary situated under libcuopt/bin folder.
+    """
+    server_path = os.path.join(
+        os.path.dirname(__file__), "bin", "cuopt_grpc_server"
+    )
+    sys.exit(subprocess.call([server_path] + sys.argv[1:]))

python/libcuopt/pyproject.toml

@@ -47,6 +47,7 @@ libcuopt = "libcuopt"
 
 [project.scripts]
 cuopt_cli = "libcuopt._cli_wrapper:main"
+cuopt_grpc_server = "libcuopt._grpc_server_wrapper:main"
 
 [tool.pydistcheck]
 select = [