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.
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.integrationshelper module (App,OaiGnb,OaiUe, andIntegrationError) 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, andintegration_fetch) toMultiUSRPDynamic v2 bindings along with typed.pyistub annotations. - Added a user-facing
region_blockedmessage when RemoteRF Global returns HTTP 451 for a restricted region.
Fixes (1)
- Fixed
remoterf.integrations.Appto raiseIntegrationError(with.code) on server refusals carryingdetails.integration_codeand retry only transport failures rather than retrying refused calls.
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, andgps) that automatically adapt to the schema served by the deployment. - Added automatic retry with backoff (up to 90 s, configurable via
REMOTERF_RESTART_WAIT) soGET,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/memoryviewobjects, empty lists and tuples ([]/()), and byte or string lists with trailing NUL bytes. - Fixed Global reservation listings (
getres,myres, andcancelres) to display the device handle (Name@deployment) instead of the owner label.
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 withREMOTERF_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-hostnodes on Global Deployments.
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, anddoctor) with--jsonoutput 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@deploymentdevice handles (such asPluto_00@ucla) across all drivers. - Added structured JSON error reporting with stable error codes and
retry_afterbackoff metadata.
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 HANDLEto inspect constructors, properties, and methods directly from a deployment's live IDL schema. - Added
remoterf example HANDLE --recipe connect|rx_once|rx_spectrumto generate ready-to-run receive and spectrum scripts. - Added
remoterf auth loginandremoterf auth status --jsonfor 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.
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) withuhd.usrp.MultiUSRPcompatibility 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.
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
remoterfrelease 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.