Troubleshooting & FAQ
"Session expired" error
Cause: Your session token has expired (default: 8 hours).
Fix: Refresh the page and log in again.
Algorithm results show "project not found"
Cause: The Project ID doesn't exist in the graph yet.
Fix: Go to Journey, start a project, and use the Project ID from there.
DocIntel status stuck at PARSING
Cause: Large IFC files (>100MB) or malformed files can stall the parser.
Fix: Check the backend logs. Try exporting a fresh copy of the IFC from your source software. For very large models, split into storeys and import separately.
LAD shows "no project" overlay
Cause: No project ID is set in the session.
Fix: Go to Journey, create or open a project. The project ID propagates to LAD automatically.
GIS analysis returns generic results
Cause: The location description is too vague.
Fix: Use a specific address with postcode, or include city + country. E.g. "EC1A 1BB, London, UK" rather than "London".
"License validation failed" on startup
Cause: The PURPLE8_LICENSE_KEY environment variable is missing or corrupt.
Fix: Contact your system administrator to regenerate the license key via the Admin → License panel.
Compliance tab shows no results
Cause: No elements in the project graph yet.
Fix: Create elements in BIM Viewport or import via DocIntel first.
Chat responses are slow (>10 seconds)
Cause: LLM provider latency, or complex multi-tool queries.
Fix: Check LLM settings — consider using a faster model (gpt-4o-mini) for simple queries. Set a lower max_tokens if responses are longer than needed.