python-debugpy

Diagnose Python execution failures with breakpoints, stack frames, and live variables.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you inspect and fix Python bugs when print statements are not enough, especially for failing tests, confusing state changes, long-running services, and crashes that need post-mortem analysis.

Core Features & Use Cases

  • Local breakpoints with pdb: Pause execution with breakpoint() or python -m pdb and inspect variables, the call stack, and control flow interactively.
  • Test debugging: Drop into pdb for failing pytest cases, trace execution from test start, and diagnose local state in a controlled way.
  • Remote and headless debugging: Use debugpy or remote-pdb to attach to running processes, daemon-like services, gateways, and subprocesses without restarting everything.
  • Use Case: A Hermes gateway or TUI worker misbehaves in production-like conditions, so you attach remotely, set breakpoints, and inspect the exact frame where the bug occurs.

Quick Start

Tell me to debug the Python issue by choosing the right mode, adding a breakpoint or remote attach point, and guiding me through pdb or debugpy based on whether the process is local, a test, or already running.

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 Python script locally using pdb?

Debug Python locally by inserting breakpoint() into your script or running python -m pdb. This pauses execution so you can inspect live variables, step through stack frames, and trace control flow interactively.

Can I drop into pdb for a failing pytest case?

Debug failing pytest cases by using pytest debugging flags to drop into pdb. This pauses the test at the failure point, allowing you to trace execution from the start and diagnose local state interactively.

What is the best way to debug a running Python service without restarting?

Debug running Python services without restarting by using debugpy or remote-pdb to attach to the live process. This allows remote, headless debugging of daemon-like services and subprocesses directly at the failure frame.

Does this approach work for post-mortem crash analysis in Python?

Post-mortem crash analysis in Python is supported by inspecting stack frames and live variables after a failure occurs. This helps diagnose confusing state changes and execution failures without needing print statements.

When should I use remote-pdb instead of standard pdb breakpoints?

Use remote-pdb instead of standard pdb when debugging headless processes, daemon-like services, gateways, or subprocesses. Remote-pdb provides terminal access to attach to already running processes where interactive local breakpoints are impossible.