esp-idf-panic-decoder
ESP-IDF panic decoder
Decision gist · record as of 2026-08-14
Yes. If you develop for Espressif microcontrollers and need to debug crashes from panic dumps, this is the standard tool. It has low install friction, active maintenance, permissive licensing, no known vulnerabilities, and is widely used in the embedded community. Install it if you work with ESP-IDF projects and encounter panic output you need to decode.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires GDB to be installed and available on the system; designed for use with Espressif ESP-IDF projects.
- Low install friction with only two lightweight runtime dependencies (pyelftools and pyparsing).
- Actively maintained with a recent release; repository is not archived and receives regular commits.
License · maintenance · safety
permissive license (permissive) — Released under Apache License Version 2.0, a permissive open-source license that allows commercial use, modification, and redistribution with minimal restrictions—suitable for both proprietary and open-source projects.
last release 2026-04-13 (123 days) · last repo commit 2026-06-30 · 7 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 475,002 downloads/mo, #6,451 on PyPI
Alternatives
Verify before relying
pip install esp-idf-panic-decoder
from esp_idf_panic_decoder import panic_decoder
# Parse panic output and connect to GDB
panic_decoder.main()- Whether the package works with all ESP-IDF versions or has specific version constraints beyond Python 3.7+.
- Performance characteristics when processing very large stack dumps or multiple panic outputs in sequence.
- Availability of command-line interface documentation or examples beyond the description excerpt provided.
- Whether pyelftools and pyparsing have any known vulnerabilities or compatibility issues.
What it is and what it does
esp-idf-panic-decoder is a Python tool that decodes crash information from Espressif microcontrollers running ESP-IDF. It reads panic handler output—register values and raw stack memory—and acts as a GDB server, translating that low-level data into human-readable backtraces. This is particularly useful on embedded architectures where the target device cannot perform backtracing itself, allowing developers to debug crashes remotely by feeding panic dumps into GDB.
The package is part of the official ESP-IDF SDK and depends on pyelftools and pyparsing to parse ELF binaries and structured output. It runs on Python 3.7 through 3.13 across macOS, Windows, and POSIX systems, making it accessible in most embedded development environments.
Use it for
- Debugging Espressif chip crashes by converting panic dumps into GDB-readable backtraces.
- Analyzing stack memory from production devices that logged panic output but cannot run a debugger locally.
- Automating crash analysis in CI/CD pipelines by parsing panic logs and generating structured debug information.
- Post-mortem debugging of embedded systems where live GDB connection is not available during the crash.
- Reverse-engineering the call stack from raw register and memory state captured at panic time.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
If you develop for Espressif microcontrollers and need to debug crashes from panic dumps, this is the standard tool. It has low install friction, active maintenance, permissive licensing, no known vulnerabilities, and is widely used in the embedded community. Install it if you work with ESP-IDF projects and encounter panic output you need to decode.
Install
esp-idf-panic-decoder on PyPI
Before you install
Low install friction with only two lightweight runtime dependencies (pyelftools and pyparsing). Actively maintained with a recent release; repository is not archived and receives regular commits.
Requires GDB to be installed and available on the system; designed for use with Espressif ESP-IDF projects.
License in practice
Released under Apache License Version 2.0, a permissive open-source license that allows commercial use, modification, and redistribution with minimal restrictions—suitable for both proprietary and open-source projects.
Quickstart
pip install esp-idf-panic-decoder
from esp_idf_panic_decoder import panic_decoder
# Parse panic output and connect to GDB
panic_decoder.main()Verify before relying
- Whether the package works with all ESP-IDF versions or has specific version constraints beyond Python 3.7+.
- Performance characteristics when processing very large stack dumps or multiple panic outputs in sequence.
- Availability of command-line interface documentation or examples beyond the description excerpt provided.
- Whether pyelftools and pyparsing have any known vulnerabilities or compatibility issues.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespyelftoolspyparsing |
| Maintenance | Actively maintained 123 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 475,002 / month, #6,451 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseNatural Language :: EnglishOperating System :: MacOS :: MacOS XOperating System :: Microsoft :: WindowsOperating System :: POSIXProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.13Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Embedded Systems |
Evidence: esp_idf_panic_decoder-1.5.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “esp-idf panic decoder”
- esp-idf-panic-decoderParses ESP-IDF panic handler output (registers and stack dumps) and…
- pytest-embedded-idfA pytest plugin that integrates ESP-IDF embedded systems testing with…
- esp-idf-monitorProvides serial communication monitoring and interaction for…
Give your agent the search over MCP, or paste the wish link into any chat.
More Embedded Systems packages
Provides Python abstractions and utilities for Controller Area Network (CAN) communication, supporting multiple hardware backends and message logging formats.
Install it if you need to communicate with CAN buses from Python.
Provides quaternion representation, manipulation, and rotation operations for 3D geometry and animation, with support for smooth interpolation between orientations.
Calculates CRC and checksum values from binary data using parametrized algorithms from the CRC catalogue, supporting dozens of standard CRC variants and additive/XOR checksums.
Install it if you need standard CRC calculations; avoid it only if you require active feature development or real-time performance guarantees.
esptool is a serial utility for flashing, provisioning, and interacting with Espressif microcontroller SoCs over a serial connection.
Install it if you develop or deploy firmware on Espressif SoCs.
Provides kconfig language support and IDE tooling for configuring Espressif ESP-IDF embedded projects, including configuration parsing, validation, and documentation generation.
pyOCD is a Python-based debugger and programmer for Arm Cortex-M microcontrollers that works with many debug probes across Linux, macOS, Windows, and FreeBSD.
See also esp-coredump · la-panic · esp-idf-diag · esp-idf-monitor · idf-component-manager · esp-idf-size · esp-bool-parser · pytest-embedded-idf · pygdbmi