--- id: remote-pdb version: "2.1.0" license: BSD-2-Clause license_treatment: permissive maintenance: abandoned --- # remote-pdb — Remote vanilla PDB (over TCP sockets) *done right*: no extras, proper handling around connection failures and CI. Based on `pdbx `_. License: permissive · Maintenance: abandoned · Downloads: 823.8K/mo ## What it is and what it does remote-pdb is a minimal wrapper around Python's standard pdb debugger that listens on a TCP socket, allowing you to attach a debugger session from a remote machine using telnet, netcat, or socat. You embed a call to set_trace() in your code or use the PYTHONBREAKPOINT environment variable to trigger it; the debugger then waits for an incoming connection on a specified host and port. It handles the socket plumbing and connection lifecycle so you don't have to. The package has no runtime dependencies and installs as a pure Python wheel. It supports Python 2.7 through 3.8 (and PyPy) according to its classifiers, though the project is no longer maintained. It's useful for debugging applications running in containers, CI environments, or other contexts where you can't easily attach a local debugger, but you should be aware that you'll receive no updates for compatibility issues or security concerns. Use it for: - Debug a Python application running inside a Docker container by mapping the debug port and connecting from your host machine. - Troubleshoot a long-running background process or daemon without stopping it, by inserting set_trace() and connecting over the network. - Diagnose failures in CI/CD pipelines where interactive debugging is normally impossible, by opening a remote session on demand. - Attach a debugger to a production process (with caution) when local debugging tools are unavailable or impractical. ## Worth the install? AI-flagged interpretation of the facts above — verify before relying. Exposes Python's debugger (pdb) over a TCP socket so you can connect remotely via telnet or netcat to debug a running process without stopping it. Yes, if you need remote debugging and accept the maintenance risk. The package is stable, has no dependencies, and solves a specific problem well—but it has been abandoned since 2020 and will not be updated for new Python versions or security issues. Use it for development and testing, not production-critical workflows, and monitor your Python version compatibility yourself. ## Install pip install remote-pdb uv add remote-pdb poetry add remote-pdb ## Installing remote-pdb Before you install: Installation is frictionless (pure Python wheel, no runtime dependencies), but the package is abandoned—last release was 2020-07-24 and last commit 2022-10-24. It remains stable for its narrow scope, but you'll receive no updates for new Python versions or security issues. License in practice: BSD-2-Clause is permissive and imposes minimal restrictions; you can use, modify, and distribute this package freely in commercial and private projects with only attribution and liability disclaimer required. Quickstart: pip install remote-pdb from remote_pdb import set_trace set_trace() # logs the port; connect via: telnet 127.0.0.1 # Or with explicit host/port: from remote_pdb import RemotePdb RemotePdb('127.0.0.1', 4444).set_trace() Requires a way to connect to the listening socket (telnet, netcat, or socat). In containers, the port must be mapped and the host set to 0.0.0.0, not localhost. Verify before relying: - Whether the package works reliably on Python versions beyond 3.8 (classifiers list up to 3.8, but requires_python allows current versions; actual compatibility untested). - Whether readline issues on macOS (mentioned in docs) remain present or have been resolved in modern Python. ## Package facts - License: BSD-2-Clause (permissive) - Python support: supports_current - Install friction: low - Maintenance: abandoned - Downloads: 823.8K/month (top 5,000 on PyPI) - Known vulnerabilities: none known ## Tags remote debugging over tcp, pdb over network socket, telnet debugger connection, debug running python process, remote breakpoint handler, debugging, network-socket, abandoned [View on SkillFed](https://skillfed.io/packages/remote-pdb) · [View on PyPI](https://pypi.org/project/remote-pdb/)