remote-pdb

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 on this page — 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

remote-pdb on PyPI

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 <port>

# 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

Evidence: remote_pdb-2.1.0-py2.py3-none-any.whl

Tags

More Utilities packages