{"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,"search_vec":"'0.2.0':29 '2021':34 '4444':18 'allow':19 'around':6 'connect':22 'current':27 'debug':35,38 'debugg':4,11 'default':16 'expos':9 'infrequ':30 'last':32 'maintain':31 'netcat':26 'pdb':7,39 'port':17 'releas':33 'remot':3,37 'remote-debug':36 'rpdb':1 'socket':15 'tcp':14 'telnet':24 'version':28 'wrapper':5","created_at":"2026-05-01T08:13:37.370036+00:00","updated_at":"2026-05-01T08:13:37.370036+00:00","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,"quickstart_score":null,"quickstart_tag":null,"pypi_latest":"0.2.0","cli_name":"","cli_version":null,"type":"library","homepage":"http://tamentis.com/projects/rpdb","github":null,"docs":null,"changelog":null,"pypi":"https://pypi.org/project/rpdb/","npm":null,"openapi_spec":null,"status_page":null,"smithery":null,"categories":["testing","devops"],"base_url":null,"auth_type":null,"provenance":{"verified_status":"passing","verified_at":"2026-06-29","last_verified":"2026-06-29","next_check":"2026-07-29","install_tag":null}}