Troubleshooting

First diagnostic command

python -c "import pyhuge; print(pyhuge.test())"

If runtime=True, core deps are available.

Full environment snapshot

pyhuge-doctor

Symptom -> cause -> fix

PyHugeError: Native runtime for pyhuge is unavailable

Cause: one or more runtime deps missing (numpy, scipy, native extension).

Fix:

python -m pip install "pyhuge[runtime]"

... requires native C++ core (pyhuge._native_core)

Cause: native extension is missing or failed to load in current environment.

Fix:

python -m pip install --force-reinstall pyhuge

Plotting import error (matplotlib / networkx)

Fix:

python -m pip install "pyhuge[viz]"

Headless environment:

export MPLBACKEND=Agg

error: externally-managed-environment (PEP 668)

Use a virtual environment:

python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install "pyhuge[runtime]"

index out of range when plotting

Cause: index outside fit.path bounds.

Fix: use index=-1 for the last graph or a valid index in [0, len(fit.path)-1].

criterion='ebic' requires a glasso fit

Cause: EBIC was requested for non-glasso estimator.

Fix: run huge(..., method="glasso") first, then huge_select(..., criterion="ebic").