Releases

Track new features, improvements, and bug fixes for the RemoteRF Python client and CLI (remoterf). For server and edge host release notes, see Deployment Releases.

Published on PyPI and GitHub. Upgrade with pip install -U remoterf.
v2.13.16 Latest

USRP application integrations, client App/OaiGnb helpers, and region-block messaging

This release adds application integration methods on USRP sessions, a high-level Python helper module for managing integrations and artifact downloads, typed refusal errors, and clearer region-restriction messaging.

Improvements (3)
  • Added the remoterf.integrations helper module (App, OaiGnb, OaiUe, and IntegrationError) with context-manager lifecycle control, attribute-based configuration, declared action methods, idempotent request-key retries, and chunked artifact fetching with automatic NumPy, JSON, and binary decoding.
  • Added the seven integration_* methods (integration_list, integration_describe, integration_start, integration_status, integration_stop, integration_call, and integration_fetch) to MultiUSRP Dynamic v2 bindings along with typed .pyi stub annotations.
  • Added a user-facing region_blocked message when RemoteRF Global returns HTTP 451 for a restricted region.
Fixes (1)
  • Fixed remoterf.integrations.App to raise IntegrationError (with .code) on server refusals carrying details.integration_code and retry only transport failures rather than retrying refused calls.
v2.13.12

Native device driver imports, server restart ride-through, and RPC codec fixes

This release adds native Python imports for all built-in device types, automatic call retries across brief server restarts, and fixes for nested bytes, empty lists, and federated reservation labels.

Improvements (2)
  • Added native Python driver imports for all built-in device types (adalm_pluto, adalm_pluto_mimo, usrp, rtlsdr, hackrf, krakensdr, ti_awr6843, rfbeam_kmd7, wifi, bluetooth, and gps) that automatically adapt to the schema served by the deployment.
  • Added automatic retry with backoff (up to 90 s, configurable via REMOTERF_RESTART_WAIT) so GET, SET, rx, rx_n, IDL:*, and getter/setter batch calls ride through brief server restarts without failing.
Fixes (2)
  • Fixed RPC and v2 codec serialization for nested bytes/bytearray/memoryview objects, empty lists and tuples ([]/()), and byte or string lists with trailing NUL bytes.
  • Fixed Global reservation listings (getres, myres, and cancelres) to display the device handle (Name@deployment) instead of the owner label.
v2.13.6

Automatic slot reservation by handle, bare Global tokens, and direct host streaming

This release adds automatic current-slot booking when connecting by device handle, bare 12-character Global reservation tokens, and direct ICE/QUIC or Global sub-slot streaming to remote hosts.

Improvements (3)
  • Connecting in Python with a device handle (Name@deployment) when you hold no active reservation on that device now automatically books the current time slot if the device is online and the slot is free (disable with REMOTERF_AUTO_RESERVE=0).
  • Simplified Global reservation tokens to bare 12-character lowercase alphanumeric codes ([a-z0-9]{12}) that work from any machine without a login.
  • Added direct ICE/QUIC and Global relay sub-slot streaming directly to remote remoterf-host nodes on Global Deployments.
v2.12.2

MCP server, non-interactive CLI, and device handles

This release adds a local Model Context Protocol (MCP) server and coding-agent skills, non-interactive CLI subcommands with JSON output, and @deployment device handles.

Improvements (4)
  • Added non-interactive CLI subcommands (remoterf devices, slots, reservations, reserve, cancel, api, example, and doctor) with --json output for scripts and automation.
  • Added a local MCP server (remoterf mcp) and skill installer (remoterf skill install) for Claude Code, Codex CLI, Gemini CLI, and Cursor.
  • Added support for Name@deployment device handles (such as Pluto_00@ucla) across all drivers.
  • Added structured JSON error reporting with stable error codes and retry_after backoff metadata.
v2.11.0

Live API inspection, starter recipes, and persistent login

This release introduces CLI tools to inspect live device APIs and generate starter receive scripts, along with persistent credential storage across deployments. It includes 3 improvements and 2 fixes.

Improvements (3)
  • Added remoterf api HANDLE to inspect constructors, properties, and methods directly from a deployment's live IDL schema.
  • Added remoterf example HANDLE --recipe connect|rx_once|rx_spectrum to generate ready-to-run receive and spectrum scripts.
  • Added remoterf auth login and remoterf auth status --json for persistent credential management.
Fixes (2)
  • Fixed gRPC channel cleanup on Python interpreter exit to prevent hanging background threads.
  • Improved error messages when a reservation token is used before its start time or after expiration.
v2.0.0

Dynamic runtime driver loader, USRP UHD API, and ADALM-PLUTO MIMO

This major release replaces static device wrappers with runtime schema-driven driver loading and adds support for USRP transceivers and dual-channel ADALM-Pluto MIMO.

Improvements (4)
  • Added the runtime schema-driven driver loader (from remoterf.drivers import ensure_driver) for HackRF One, RTL-SDR, and custom deployment-defined devices.
  • Added the USRP driver (remoterf.drivers.usrp.uhd) with uhd.usrp.MultiUSRP compatibility for USRP 2901, USRP B205-mini, and USRP N210.
  • Added dual-channel phase-coherent ADALM-PLUTO MIMO support via adi.ad9361.
  • Updated client-server streaming transport to schema-versioned protobuf messages for lower latency and higher sustained I/Q throughput.
v1.1.8

Interactive CLI reservation calendar and cross-platform terminal support

This release improves the interactive reservation workflow across Windows, macOS, and Linux terminals and adds automatic PyPI version checks.

Improvements (2)
  • Added startup version checks in the interactive CLI when a newer remoterf release is available on PyPI.
  • Improved interactive slot calendar navigation and keybinding handling on Windows PowerShell, macOS, and Linux.
Fixes (1)
  • Fixed buffer timeout handling when receiving large I/Q captures over high-latency VPN connections.