Python troubleshooting index#

Start with the symptom you can observe. Preserve the first exception, HTTP status, or browser-console error: it usually identifies the owning layer.

Installation and dependencies

Import errors, interpreter mismatches, and installation checks.

Data preparation

Shape, dtype, identity, embedding, metadata, expression, graph, and export validation.

Viewer embedding

Notebook display, iframe reachability, asset delivery, and browser errors.

Server mode

Bind failures, URLs, HTTP responses, remote access, and process lifecycle.

Hooks and events

Viewer IDs, callbacks, event validation, and session-bundle requests.

Performance and memory

Separate export time, I/O, browser rendering, and analysis costs.