rpdb
pdb wrapper with remote access via tcp socket
Decision gist · record as of 2026-08-14
Yes, if you specifically need remote debugging over a socket and accept the dormant maintenance status. The package is lightweight, has no dependencies, and works on modern Python (3.8–3.12). However, verify the license before use in proprietary code, test thoroughly in your environment given the inactive maintenance, and be aware of the known socket-closure bug. Not recommended as a primary debugger for active development; better suited for ad-hoc remote troubleshooting.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- The debugger blocks execution until a remote client connects; ensure your deployment environment permits inbound TCP connections on the chosen port (default 4444).
- Installation is straightforward with no runtime dependencies.
- The package is dormant (596 days since last release) but supports current Python versions (3.8–3.12); use it only if you accept that maintenance is inactive.
License · maintenance · safety
(unclear) — License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before use in proprietary or restricted contexts.
last release 2024-12-26 (596 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 84,980 downloads/mo, #13,963 on PyPI
Alternatives
Verify before relying
pip install rpdb
import rpdb
rpdb.set_trace()
# Then connect from another terminal:
# nc 127.0.0.1 4444- Whether the unclear license is documented elsewhere (e.g., in the repository or source distribution).
- Current stability and compatibility with Python 3.10–3.12 in production environments, given the dormant maintenance status.
- Whether the known socket-closure bug and Jython-specific issues remain unfixed.
What it is and what it does
rpdb is a minimal wrapper around Python's built-in pdb debugger that redirects stdin and stdout through a TCP socket instead of the console. When you call `rpdb.set_trace()` in your code, execution pauses and waits for a remote client (telnet, netcat, or similar) to connect on a specified port (default 4444). Once connected, you interact with the debugger over the network as if you were using pdb locally.
The package was originally designed to debug Jython applications running in Tomcat, where direct console access is impractical, but it works on CPython 3.8 and later. It has no runtime dependencies and installs as a pure Python wheel. The package is dormant—last released 596 days ago—and carries known limitations: the socket may not close cleanly on exit, and there are documented issues with Jython 2.5. Use it when you need to attach a debugger to a long-running or remote process without modifying its startup or deployment.
Use it for
- Debug a Python application running in a containerized or remote environment where console access is unavailable.
- Attach a debugger to a long-running server or background process without stopping and restarting it.
- Debug Jython applications deployed in Tomcat or other Java application servers.
- Trigger interactive debugging on demand by sending a SIGTRAP signal to a running process.
- Diagnose issues in production-like environments where direct IDE debugging is not feasible.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you specifically need remote debugging over a socket and accept the dormant maintenance status.
The package is lightweight, has no dependencies, and works on modern Python (3.8–3.12). However, verify the license before use in proprietary code, test thoroughly in your environment given the inactive maintenance, and be aware of the known socket-closure bug. Not recommended as a primary debugger for active development; better suited for ad-hoc remote troubleshooting.
Install
rpdb on PyPI
Before you install
Installation is straightforward with no runtime dependencies. The package is dormant (596 days since last release) but supports current Python versions (3.8–3.12); use it only if you accept that maintenance is inactive.
The debugger blocks execution until a remote client connects; ensure your deployment environment permits inbound TCP connections on the chosen port (default 4444).
License in practice
License status is unclear—no SPDX identifier or raw license text is available in the package metadata. Verify the actual license before use in proprietary or restricted contexts.
Quickstart
pip install rpdb
import rpdb
rpdb.set_trace()
# Then connect from another terminal:
# nc 127.0.0.1 4444
Verify before relying
- Whether the unclear license is documented elsewhere (e.g., in the repository or source distribution).
- Current stability and compatibility with Python 3.10–3.12 in production environments, given the dormant maintenance status.
- Whether the known socket-closure bug and Jython-specific issues remain unfixed.
Package facts
| License | Not declared unclear |
| Python support | Supports the current Python release >=3.8 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Dormant 596 days since the last release |
| First released | |
| Downloads | 84,980 / month, #13,963 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Programming Language :: Python :: 3Programming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9 |
Evidence: rpdb-0.2.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “pdb over network”
- rpdbrpdb is a remote debugger that wraps Python's pdb and routes…
- remote-pdbExposes Python's debugger (pdb) over a TCP socket so you can connect…
- pdbpppdbpp is a drop-in replacement for Python's standard pdb debugger…
Give your agent the search over MCP, or paste the wish link into any chat.
More Software Development packages
Provides backported and experimental type hints for Python 3.9+, allowing use of newer typing features on older Python versions and enabling early experimentation with type system PEPs before they enter the standard library.
NumPy provides an N-dimensional array object and a comprehensive suite of mathematical, linear algebra, Fourier transform, and random number functions for scientific computing in Python.
FastAPI is a Python web framework for building REST APIs using type hints, with automatic request validation, serialization, and interactive API documentation.
Provides a way to document function parameters, class attributes, return types, and variables inline using Python's `Annotated` type hint syntax instead of traditional docstrings.
Typer builds command-line applications from Python functions using type hints, automatically generating help text, argument parsing, and shell completion.
Install it if you are building CLIs in Python.
Distlib provides low-level packaging utilities for building, distributing, and managing Python software—including metadata handling, version specifiers, wheel support, script installation, and dependency resolution.
See also remote-pdb · web-pdb · pdb-attach · manhole · ipdb · pdbr · pdbp · pdbpp · debugpy · lauterbach-trace32-rcl