What problem does it solve?
Manually tuning esp-ppq quantization settings (calibration algorithms, TQT, equalization, bias correction, mixed precision) to recover post-quantization accuracy on ESP-DL targets is slow and error-prone. This Skill replaces the guess-and-rerun loop with a structured, distribution-aware search that iterates toward a target metric automatically.
Core Features & Use Cases
- Phased search state machine: Runs a baseline, then a calibration × TQT cartesian product, then single-lever residual fixes, then agent-driven open exploration, with automatic plateau and target-reached detection.
- Structured iteration artifacts: Each run emits metrics.json, layerwise_error.json, layer_stats_full.json, non_computing_hot_ops.json, and graphwise_jumps.json so decisions are driven by per-layer distribution data.
- Target-aware safety checks: Auto-disables LSQ on POWER_OF_2 targets (esp32p4, esp32s3, c) and warns on layer-wise equalization for esp32p4 per-channel weights.
- Use Case: Quantize a MobileNet-V2 model for ESP32-P4, find top-1 accuracy dropped after int8 quantization, and let the Skill iterate over calibration algorithms, TQT schedules, equalization, and int16 dispatching until the target accuracy is recovered.
Quick Start
Provide a user_quant.py module with your calibration dataloader and evaluate function, then ask the agent to run the espdl-quantize skill to tune my esp-ppq quantization settings until the target accuracy is reached.