---
id: nexus-rpc
version: "1.4.0"
license: MIT
license_treatment: permissive
maintenance: active
---

# nexus-rpc — Nexus Python SDK

License: permissive · Maintenance: active · Popularity: top 1,000 on PyPI

## Install

pip install nexus-rpc
uv add nexus-rpc
poetry add nexus-rpc

## Description

# Nexus Python SDK

⚠️  **This SDK is currently at an experimental release stage. Backwards-incompatible changes are anticipated until a stable release is announced.** ⚠️

## What is Nexus?

[Nexus](https://github.com/nexus-rpc/) is a synchronous RPC protocol. Arbitrary duration operations are modeled on top of
a set of pre-defined synchronous RPCs.

A Nexus caller calls a handler. The handler may respond inline (synchronous response) or
return a token referencing the ongoing operation (asynchronous response). The caller can
cancel an asynchronous operation, check for its outcome, or fetch its current state. The
caller can also specify a callback URL, which the handler uses to deliver the result of
an asynchronous operation when it is ready.

## Installation

```
uv add nexus-rpc
```
or
```
pip install nexus-rpc
```

## Usage

The SDK currently supports two use cases:

1. As an end user, defining Nexus services and operations.

2. Implementing a Nexus handler that can accept and respond to incoming Nexus requests, dispatching to the corresponding user-defined Nexus operation.

The handler in (2) would form part of a server or worker that processes Nexus requests; the SDK does...

## AI interpretation — verify before relying

Nexus Python SDK implements a synchronous RPC protocol that models arbitrary-duration operations through predefined synchronous RPCs, supporting both service definition and handler implementation for request processing.

Verdict: Nexus-rpc is an actively maintained SDK for building synchronous RPC services with support for long-running operations. Low install friction and permissive MIT licensing make it accessible, but the explicit experimental stage and anticipated backwards-incompatible changes warrant caution for production use.

[View on SkillFed](https://skillfed.io/packages/nexus-rpc) · [View on PyPI](https://pypi.org/project/nexus-rpc/)