python-debugpy

Debug Python applications with pdb and the Debug Adapter Protocol.

1|Updated Jul 31, 2026
One-click install
npx skills add https://github.com/icyzh/hermes-web --skill python-debugpy-icyzh
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: python-debugpy
Source: https://github.com/icyzh/hermes-web/tree/main/skills/software-development/python-debugpy
Command: npx skills add https://github.com/icyzh/hermes-web --skill python-debugpy-icyzh

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires debugpy, remote-pdb.

What problem does it solve?

This skill resolves complex Python runtime issues by providing a structured approach to interactive debugging, allowing developers to inspect state, trace execution, and resolve bugs in both local and remote environments.

Core Features & Use Cases

  • Interactive Debugging: Utilize pdb for local step-through debugging, stack inspection, and variable mutation.
  • Remote DAP Debugging: Use debugpy to attach to long-running processes, daemons, or headless services for remote inspection.
  • Post-Mortem Analysis: Capture exception states to diagnose crashes in production-like environments.
  • Use Case: When a long-running Hermes gateway process encounters an intermittent error, use this skill to attach a debugger to the live process and inspect the internal state without restarting the service.

Quick Start

Use the python-debugpy skill to attach a debugger to the running process with PID 1234 on port 5678.

Frequently Asked Questions about python-debugpy

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

FAQPage Schema
How do I attach a Python debugger to a running process?

To attach a Python debugger to a running process, use debugpy to connect to the target process via the Debug Adapter Protocol on a specified port, allowing remote inspection of live daemons without restarting.

What is the best way to inspect a Python call stack after a crash?

The best way to inspect a Python call stack after a crash is using post-mortem exception analysis, which captures the exception state to diagnose errors in production-like environments.

Can I use pdb for remote debugging on headless services?

pdb is designed for local interactive step-through debugging, whereas remote debugging on headless services requires using debugpy and the Debug Adapter Protocol to attach to long-running processes.

How does the Debug Adapter Protocol work with Python applications?

The Debug Adapter Protocol works with Python applications by allowing debugpy to attach to live processes, facilitating deep inspection of call stacks, variable state, and thread execution across deployment environments.

Do I need to restart a long-running Python service to debug an intermittent error?

You do not need to restart a long-running Python service to debug an intermittent error; debugpy can attach to the live process to inspect internal state and trace execution during runtime.