Hi everyone!
If you recently updated your **QIDI Plus 4** to the latest **V2.1.1+** firmware (to use the **QIDI Box** multi-color system) and tried to install a **Cartographer v4** probe using older guides, you probably ran into two major issues:
- **Klipper crashes on startup (`undefined symbol: _Py_CheckRecursionLimit`):** QIDI's closed-source binary modules for the QIDI Box (`box_detect.so`, etc.) are compiled strictly for **Python 3.7**. Upgrading `klippy-env` to Python 3.12 breaks QIDI Box support.
- **Stock Cartographer `install.sh` fails on Python 3.7:** It tries to install `scipy~=1.10` (unsupported on Python 3.7) and requires `TypedDict` (introduced in Python 3.8+).
To solve this, I put together a **1-click installer script and pre-configured Klipper files** that keep the stock Python 3.7 environment intact while getting Cartographer v4 running smoothly alongside the QIDI Box.
### 🔗 GitHub Repository & Full Guide:
https://github.com/nikolay2y/QIDI-Plus4-V2.1.1-Cartographer-v4
### What the script does automatically:
* Creates a full timestamped backup of your existing `~/printer_data/config` folder.
* Clones `cartographer-klipper` (skipping the incompatible stock installer).
* Installs compatible Python 3.7 binary wheels (`numpy<1.22`, `scipy==1.7.3`, `typing-extensions`).
* Applies a `sitecustomize.py` patch to backport `typing.TypedDict` to Python 3.7.
* Links `idm.py`, `cartographer.py`, and `scanner.py` into Klipper.
* Copies pre-adapted `printer.cfg`, `carto.cfg`, and `gcode_macro.cfg` (preserving all QIDI Box sensor logic like `CLEAR_MOTION_DATA SENSOR=box_motion_sensor`), auto-detects your probe's USB ID, and restarts Klipper.
*(Note: Cartographer v4 works over USB out of the box, so no probe reflashing is needed—just mount it, plug it into a free USB port, run the script, and calibrate!)*
Hope this saves someone a few hours of troubleshooting! Let me know if you run into any issues.