Python Debugpy — Debug Python: pdb REPL + debugpy remote (DAP)
Python Debugpy — Debug Python: pdb REPL + debugpy remote (DAP)
Finding
Denne side er vigtig, fordi den giver Hermes en sikker og konkret måde at fejlfinde Python-processer, tests, gateway-handlers og langkørende agentkomponenter uden at bygge ekstra debug-infrastruktur.
What it is
Det er en bundled Hermes-skill til Python-debugging med `pdb`, `python -m pdb`, `debugpy` og `remote-pdb`. Den forklarer, hvornår man bruger simple breakpoints, pytest-debugging, post-mortem debugging og remote attach til processer, der allerede kører. Den er især relevant for Hermes’ egne Python-processer, gateways, subprocesses og testfejl.
Should we use it?
Use now. For Lisa’s Hermes+n8n+LangGraph mission bør den bruges som standard debugging-metode, når Hermes-native Python-kode eller agent-runtime opfører sig forkert. Den skal ikke være en del af daglig automation, men være et operationelt værktøj ved fejl, hængende tests, gateway-problemer eller langkørende processer. n8n og LangGraph skal ikke overtage denne type runtime-debugging; Hermes bør selv eje den.
Recommendation
Brug denne skill som førstevalg ved Python-fejl i Hermes-kernen, gatewayen eller tests, men kræv altid cleanup-verifikation bagefter: ingen `breakpoint()`, `set_trace()` eller `debugpy.listen()` må ligge tilbage i kode, der skal deployes.
Use now
- Når en Hermes-test fejler, og traceback ikke forklarer den forkerte værdi.
- Når gateway-, CLI- eller subprocess-kode hænger eller rammer en uklar branch.
- Når en langkørende Python-proces skal inspiceres uden at bygge et nyt debug-flow.
- Når pytest skal køres uden xdist for at få en reel `pdb`-prompt.
- Når en crash-situation kræver post-mortem inspection af locals og stack.
Do not use / wait
- Brug ikke debugpy/pdb til fejl, som almindelig logging eller `--showlocals` løser hurtigt.
- Brug ikke `breakpoint()` i CI, non-TTY miljøer eller public deploys.
- Brug ikke remote attach på processer med høj risiko uden klar afgrænsning og cleanup.
- Brug ikke n8n eller LangGraph som workaround for Python-runtime-debugging i Hermes.
- Vent med IDE/DAP-integration, medmindre der faktisk er behov for VS Code/Cursor/Zed attach.
Public page note
Public-safe formulering: “Hermes har en indbygget Python-debugging skill, der hjælper operatører med at inspicere tests, gateways og langkørende processer på en kontrolleret måde uden at eksponere private logs eller credentials.”