esp-coredump
Generate core dumps on unrecoverable software errors
Decision gist · record as of 2026-08-14
Yes. esp-coredump is actively maintained, has no known vulnerabilities, and solves a real problem for ESP32 developers. The low install friction and permissive license make it a straightforward addition to an embedded development workflow. Install it if you develop on ESP32 or use Espressif chips and need to debug crashes; skip it if you don't work with those platforms.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Standalone use outside ESP-IDF requires esp-gdb toolchain downloaded and added to PATH; version must match your ESP32 architecture and ESP-IDF version.
- Low friction: pure Python wheel with three straightforward dependencies (construct, pygdbmi, esptool).
- Actively maintained with a recent release; last commit 2026-07-06.
License · maintenance · safety
Apache 2.0 (permissive) — Apache 2.0 permissive license allows commercial and private use with minimal restrictions; you may use, modify, and distribute the code provided you include the license notice.
last release 2026-04-08 (128 days) · last repo commit 2026-07-06 · 19 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 1,302,690 downloads/mo, #4,083 on PyPI
Alternatives
Verify before relying
pip install esp-coredump
from esp_coredump import CoreDump
coredump = CoreDump(chip='esp32', core='./coredump.b64', core_format='b64', prog='./app.elf')
coredump.info_corefile()- Whether construct, pygdbmi, and esptool versions are pinned or have known compatibility issues with specific ESP-IDF versions.
- Performance characteristics when analyzing large core dumps or memory-constrained systems.
- Whether the tool supports ESP32-C3, ESP32-S3, and other variants beyond esp32 in the chip parameter.
What it is and what it does
esp-coredump is a Python utility for extracting and debugging core dumps generated by ESP32 microcontrollers and related Espressif chips. It works both as a standalone command-line tool and as a Python library, offering two main analysis modes: info_corefile prints register state, call stacks, task lists, and memory contents from the dump; dbg_corefile converts the dump to an ELF file and launches an interactive GDB session for manual inspection of memory and variables.
The tool is designed to integrate with ESP-IDF but can run independently if you provide the esp-gdb toolchain separately. It depends on construct for binary parsing, pygdbmi for GDB interaction, and esptool for chip communication. Core dumps are typically provided as base64-encoded files or raw binary data, and the tool requires the original ELF binary to map memory regions and symbols.
Use it for
- Analyze crash dumps from production ESP32 devices to identify the failing task, register state, and call stack.
- Debug memory corruption or stack overflow issues by inspecting memory contents and task control blocks stored in the core dump.
- Interactively examine variables and memory layout in GDB using a core dump as the debugging target instead of live hardware.
- Retrieve and decode base64-encoded core dumps transmitted from remote ESP32 devices over serial or network.
- Integrate core dump analysis into CI/CD pipelines to automatically inspect test failures on embedded targets.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes.
esp-coredump is actively maintained, has no known vulnerabilities, and solves a real problem for ESP32 developers. The low install friction and permissive license make it a straightforward addition to an embedded development workflow. Install it if you develop on ESP32 or use Espressif chips and need to debug crashes; skip it if you don't work with those platforms.
Install
esp-coredump on PyPI
Before you install
Low friction: pure Python wheel with three straightforward dependencies (construct, pygdbmi, esptool). Actively maintained with a recent release; last commit 2026-07-06. Supports Python 3.7 through 3.12.
Standalone use outside ESP-IDF requires esp-gdb toolchain downloaded and added to PATH; version must match your ESP32 architecture and ESP-IDF version.
License in practice
Apache 2.0 permissive license allows commercial and private use with minimal restrictions; you may use, modify, and distribute the code provided you include the license notice.
Quickstart
pip install esp-coredump
from esp_coredump import CoreDump
coredump = CoreDump(chip='esp32', core='./coredump.b64', core_format='b64', prog='./app.elf')
coredump.info_corefile()Verify before relying
- Whether construct, pygdbmi, and esptool versions are pinned or have known compatibility issues with specific ESP-IDF versions.
- Performance characteristics when analyzing large core dumps or memory-constrained systems.
- Whether the tool supports ESP32-C3, ESP32-S3, and other variants beyond esp32 in the chip parameter.
Package facts
| License | Apache 2.0 permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 3 packagesconstructpygdbmiesptool |
| Maintenance | Actively maintained 128 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 1,302,690 / month, #4,083 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 :: OS IndependentProgramming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Topic :: Software Development :: Embedded Systems |
Evidence: esp_coredump-1.16.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 › “ESP32 core dump analysis”
- esp-coredumpRetrieves and analyzes core dumps from ESP32 and related…
- platformioPlatformIO Core is a command-line build system and project manager…
- pystackPyStack inspects the stack frames of a running Python process or core…
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-idf-panic-decoder · esp-idf-monitor · minidump · membrowse · esp-idf-size · esp-pylib · esp-idf-diag · esp-bool-parser · pycrashreport · malduck