{"id":24541,"library":"rpdb","title":"rpdb","description":"A remote debugger wrapper around pdb that exposes the debugger on a TCP socket (default port 4444), allowing you to connect with telnet or netcat. Current version: 0.2.0. Infrequently maintained; last release 2021.","status":"maintenance","version":"0.2.0","language":"python","source_language":"en","source_url":"https://github.com/tamentis/rpdb","tags":["debugging","remote-debugging","pdb"],"install":[{"cmd":"pip install rpdb","lang":"bash","label":"Install from PyPI"}],"dependencies":[],"imports":[{"note":"rpdb is a module, not a class; it replaces pdb.set_trace() with rpdb.set_trace().","symbol":"rpdb","correct":"import rpdb"}],"quickstart":{"code":"import rpdb\nrpdb.set_trace()\n# Your code here, then connect via: nc localhost 4444","lang":"python","description":"Place rpdb.set_trace() in your code where you want to break. When the breakpoint is hit, rpdb listens on TCP port 4444. Connect using netcat or telnet to interact with the debugger."},"warnings":[{"fix":"Ensure only one process hits the breakpoint, or set RPDB_PORT environment variable to different ports per process.","message":"rpdb opens a TCP socket on port 4444. If the breakpoint is hit in a subprocess or forked process without proper setup, you may get multiple listeners or port conflicts.","severity":"gotcha","affected_versions":"all"},{"fix":"Upgrade to Python 3.8+ or pin rpdb to <0.2.0.","message":"rpdb 0.2.0 dropped support for Python <3.8. If you are on an older Python, you must use an earlier version (e.g., 0.1.5).","severity":"breaking","affected_versions":">=0.2.0"},{"fix":"Use rpdb only with the standard pdb, or consider alternatives like remote-pdb.","message":"rpdb does not work with pdb++ or other pdb replacements. It directly wraps the standard library pdb.","severity":"gotcha","affected_versions":"all"}],"env_vars":null,"last_verified":"2026-05-01T00:00:00.000Z","next_check":"2026-07-30T00:00:00.000Z","problems":[{"fix":"Run 'pip install rpdb'.","cause":"rpdb is not installed, or the environment does not have it.","error":"ImportError: No module named 'rpdb'"},{"fix":"Ensure the script is running and hits the breakpoint. Check that no firewall blocks port 4444. Verify the port with 'ss -tlnp | grep 4444' or 'netstat -an | grep 4444'.","cause":"The process with rpdb.set_trace() is not running, or the breakpoint hasn't been hit yet, or a firewall is blocking the port.","error":"Connection refused when connecting to localhost:4444"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}