Troubleshooting

Troubleshooting

Symptom	Probable cause	Solution
Repeated Ollama timeout	Too many parallel requests for a local model that serves sequentially	Reduce --max-workers (already 2 by default) and/or increase --timeout; consider --retry-failed 3
404 on a model	Misspelled model name	Check with ollama list, or let the wizard list available models; the pre-flight check prints the real list
externally-managed-environment while installing dependencies	Protected Python environment (PEP 668)	The script retries with --break-system-packages automatically; otherwise use a venv (python3 -m venv)
Empty 3D graph / loading error	No internet when the HTML was opened	Reconnect, then reload the page
Window closes instantly (compiled executable)	Build without console	Rebuild with --console (a pre-exit pause is built into the script)
ERROR: missing module(s) in the executable: psutil	PyInstaller didn't bundle psutil's compiled extension	Rebuild with --collect-all psutil — see Building an Executable
Old history/cache files error out after updating	Files written by a pre-English version (French field names)	Delete the old outputs/ (formerly sorties/) artifacts — they regenerate
A legitimate tool keeps getting flagged "high"	It runs from /tmp or a non-standard path	Whitelist it via --config — see Risk Engine; path signals are neutralized, network/integrity signals stay
No connections visible for some processes (macOS)	Not your processes; macOS requires admin rights	Run with sudo if you need them, or accept 0 connections for those
matplotlib fails to install on Termux	Missing build dependencies	pkg install matplotlib (precompiled)

Still stuck? Open an issue with the -v (DEBUG) output.