KiloClawPowered by OpenClaw
Back to Cookbook
OpenClaw recipe

Headless Plotting Fixer for HPC and Remote Sessions

Stop GUI backends from crashing long-running jobs.

Resolve "cannot connect to X server" / "no $DISPLAY" failures in Matplotlib/Jupyter/R by switching to non-interactive backends and ensuring scripts save figures instead of trying to show windows.

CommunitySubmitted by CommunityWork7 min
Try in KiloClawFree 7-day trial

INGREDIENTS

🔍Web

PROMPT

You are OpenClaw. Ask whether plotting must be interactive or can be file-only. If file-only, propose a headless-safe configuration for Matplotlib and/or R and show how to save outputs. If interactive, diagnose DISPLAY/X forwarding and propose safe remote visualization options. Provide a minimal reproducible snippet demonstrating the fix.

Pain point

Jobs on servers/HPC crash or hang when plotting, because default GUI backends try to connect to a display.

Repro/diagnostic steps

  • Capture the exact error (e.g., QXcbConnection, Tkinter $DISPLAY, kernel crash).
  • Determine if the workflow needs interactive display or just file outputs.

Root causes (common)

  • Matplotlib default backend set to Qt/GTK in a headless environment.
  • Jupyter kernels started without a valid DISPLAY/X forwarding.
  • R plot device attempts X11 in non-GUI context.

Fix workflow

  1. Force non-interactive backends early (Matplotlib: Agg; R: png/pdf devices).
  2. Replace plt.show() with savefig() in batch jobs.
  3. If interactive display is required, use X11 forwarding or a remote desktop solution.

Expected result

  • Scripts run in screen/SLURM without display errors and produce plot files deterministically.

References

  • https://stackoverflow.com/questions/38612473/pyplot-cannot-connect-to-x-server-localhost10-0-despite-ioff-and-matplotlib
  • https://github.com/matplotlib/matplotlib/issues/9140
  • https://github.com/ipython/ipython/issues/4116
Tags:#hpc#plotting#python#r

Related Recipes

Conda Solver Triage & Environment Stabilization

Turn "Solving environment…" hangs into a deterministic fix workflow.

Diagnose and resolve slow/failed conda dependency solves (hangs, frozen/flexible solve loops, UnsatisfiableError) by auditing channels, minimizing specs, and using faster solvers when appropriate.

Work10 min

CUDA Stack Sanity Check for Scientific Python

Make GPU availability a checklist, not a mystery.

Resolve CUDA driver/runtime mismatches and GPU framework install pitfalls by checking driver versions, supported CUDA toolkits, and whether binaries bundle CUDA runtimes (PyTorch/TensorFlow).

Work12 min

The De-Botinator

Wikipedia-grade AI pattern removal

Comprehensive AI writing cleanup based on Wikipedia's WikiProject AI Cleanup guidelines. Catches 24+ distinct patterns including inflated symbolism, em dash overuse, rule of three, copula avoidance, and sycophantic tone.

Creative1 min

Bulk Change Airbnb Rates

Update pricing across all your Airbnb listings without clicking through each one

Automate bulk rate changes across multiple Airbnb listings using your Claw. Useful for seasonal pricing updates, last-minute discounts, or syncing rates after a change in your hosting strategy.

Home5 min