python-debugpy

Integrate pdb REPL with debugpy remote debugging for Python code execution.

Updated Apr 20, 2026
One-click install
npx skills add https://github.com/matthew-johnson/hermes-agent --skill python-debugpy-matthew-johnson
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/matthew-johnson/hermes-agent/tree/main/skills/software-development/python-debugpy
Command: npx skills add https://github.com/matthew-johnson/hermes-agent --skill python-debugpy-matthew-johnson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Debug Python applications can be painful when you need interactive local inspection, remote attachment, and post-mortem analysis; this skill unifies pdb REPL workflows with debugpy remote debugging to simplify diagnosing and fixing issues.

Core Features & Use Cases

  • Local debugging with breakpoint() and pdb for interactive inspection.
  • Remote debugging with debugpy to attach to a running process or to start a script with a waiting client.
  • Post-mortem debugging and cross-process analysis for long-running services and test failures.
  • Clear guidance and practical workflows to attach, launch, and troubleshoot Python code across environments.

Quick Start

Tell Hermes to attach debugpy to a running Python process or start a script under pdb for immediate interactive debugging.

Frequently Asked Questions about python-debugpy

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

FAQPage Schema
How do I use pdb and debugpy for remote Python debugging?

Remote Python debugging combines pdb REPL for local inspection with debugpy DAP to attach to running processes. You configure debugpy to listen on a port, attach your client, set breakpoints, and control execution across local scripts and daemons.

Can I attach a debugger to a running Python process for post-mortem analysis?

Yes, you can attach a debugger to a running Python process for post-mortem analysis using debugpy. This allows you to inspect state after a failure, analyze long-running services, and diagnose test failures without restarting the application.

What is the best way to debug long-running Python daemons remotely?

The best way to debug long-running Python daemons is using debugpy remote attachment via DAP. You inject debugpy into the running process, connect a DAP client, set breakpoints, and inspect variables without interrupting the daemon's startup cycle.

Do I need debugpy installed to use breakpoints with pdb?

No, you do not need debugpy installed to use pdb for local breakpoints. pdb is built into Python, but debugpy is required separately when you need to attach to running processes or perform remote DAP debugging.

How do I start a Python script under pdb for interactive inspection?

To start a Python script under pdb, you launch the application with pdb enabled or insert breakpoint() calls in your code. This pauses execution and opens an interactive REPL for local variable inspection and step-by-step control.

Why use debugpy DAP instead of just pdb for Python debugging?

Debugpy DAP is used instead of pdb when you need remote attachment to running processes or cross-process analysis. pdb limits you to local terminal REPL, while debugpy supports connecting external clients for complex scenarios like long-running services.