python-debugpy

Debug local and remote Python processes using pdb and debugpy.

Updated Jun 15, 2026

Search Tags:#debugging #python #breakpoints #dap #pdb #debugpy #remote-debugging

Ready to run

npx skills add https://github.com/faramirezs/talking_printer --skill python-debugpy-faramirezs

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/faramirezs/talking_printer/tree/main/hermes-agent/skills/software-development/python-debugpy
Command: npx skills add https://github.com/faramirezs/talking_printer --skill python-debugpy-faramirezs

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debugging Python applications can be challenging when you need both local exploration and remote, long-running processes. pdb provides an interactive local REPL but is limited to the current process; debugpy enables remote debugging and DAP-based workflows, giving you attach and listen capabilities.

Core Features & Use Cases

Local debugging with breakpoint() and pdb for quick inspection and stepping through code.
Post-mortem debugging to inspect locals after an exception.
Remote debugging with debugpy to attach to running processes or start a server waiting for a client.
Flexible workflows for source-edit debugging, launching under pdb, or attaching to a PID in restricted environments.

Quick Start

Insert breakpoint() at the suspect line, run the script, and interact with pdb to inspect state.

Frequently Asked Questions about python-debugpy

High-intent search queries and answers about installing and using this skill.

FAQPage Schema

How do I debug a remote Python process using debugpy?▼

Debug a remote Python process using debugpy by configuring an attach or wait-for-client workflow. The debugpy server listens for a DAP client connection, letting you inspect state and step through code in restricted environments.

What is the best way to inspect local variables after a Python exception?▼

Inspect local variables after a Python exception using post-mortem debugging. This technique drops you into an interactive pdb REPL at the exact point of failure, allowing you to examine the application state immediately after the crash.

Can I use pdb to debug pytest tests step by step?▼

Yes, you can use pdb to debug pytest tests step by step. The framework supports pytest integration, allowing you to insert breakpoint() statements directly into test functions to pause execution and inspect variables.

Does Python remote debugging with debugpy work on macOS and Linux?▼

Python remote debugging with debugpy works on both macOS and Linux. You need a Python environment with both pdb and debugpy installed to support attach, wait-for-client, source-edit, and no-source-launch workflows.

What is the difference between pdb and debugpy for Python debugging?▼

Pdb provides interactive local REPL debugging limited to the current process, while debugpy enables remote debugging and DAP-based workflows. Debugpy gives you attach and listen capabilities for long-running processes that pdb cannot reach.

How do I start debugging a Python script under pdb?▼

Start debugging a Python script under pdb by inserting the breakpoint() function at the suspect line and running the script. Execution pauses at the breakpoint, dropping you into an interactive prompt to inspect state.