Troubleshooting

Installing and opening

macOS says it cannot check the app. The build is not notarized. Open System Settings › Privacy & Security and choose "Open Anyway". See Install and open a project.

Windows SmartScreen warns on first run. The installer is not signed yet. Click "More info", then "Run anyway".

"This build does not update itself. Builds from a tagged release do." You are on a build made without an update feed. Install a release build to get updates.

"Couldn't check for updates: …" The check failed, and the message says why. Studio tries again at the next launch; Help › Check for Updates… tries now.

The agent

"Claude Code (claude) was not found on PATH. Install it and run claude once to sign in." Install Claude Code, run claude in a terminal once, then send the message again. Studio reads the PATH of your login shell, so claude must be found from a new terminal window.

"Claude Code is not signed in. Run claude auth login and try again." Run claude auth login in a terminal, or use a firm key. See Firm API keys.

"Your firm's AI budget is used up or the key was revoked. Contact Urbium." The firm's monthly limit is reached, or your key was revoked. Ask for a new key.

"Crash reports were turned off, so the agent restarted without them. Send your message again." Turning crash reports off restarts the agent once. Send the message again.

"The app closed during this turn." Studio closed while the agent worked. Your next message resumes the agent's session.

"No Secret Service is running. Start GNOME Keyring or KWallet and log in again, or set ANTHROPIC_API_KEY before you start Urbium Studio." On Linux, saving a key needs a running keyring. Do what the message says.

Accept or Discard is greyed out. A turn is still running: wait for it, or Stop Agent (⌘.). Accept also waits while Before is on view (press Esc), and while the review bar lists a conflict: choose Keep mine or Keep base for each.

Lots and rules

"Accept or discard the open conversations before moving the building or changing the lot." Moving the building and setting the lot change the base model the conversations were copied from. Accept or discard each conversation first.

"No zoning data for <place> yet." The lot is outside the places Studio has zoning rules for. The parcel is loaded with no rules. See Lots and zoning.

"No standards loaded for <zone> yet", or a rule Not loaded. The catalog has no value for that zone or measure. Use Set a value… to give it one for this project.

A setback looks measured from the wrong line. A lot side may be typed wrong. Press S and retype it. See Lots and zoning.

Modeling

A room or mass is refused as overlapping. Rooms and masses may share an edge but not floor. The chat names the two; move or reshape one.

An edit is refused with a reason under the field. The model engine checks every edit (a door taller than its wall, a split through a door). The message says why and, where it can, what to do instead.

An edit does nothing on an element. Its layer, or the element itself in the Outliner, may be locked. Unlock it.

"Make walls to draw sheets". A Design project has no walls, so no sheets. Run Make Walls. See The handoff to BIM.

"No location for this model". The sun study needs the lot's location. Start the project on a lot, or set its lot address.

"A macro can't run now: wait for the edit in flight." Wait for the running edit to finish, then run it again.

The Undo button is gone after a restart. Undo history does not survive closing Studio. Edit the change back, or discard the conversation.

Files

A DWG is refused: "convert it to DXF first". Released builds do not read DWG yet. Save the drawing as DXF from your CAD tool and import that.

A DWG export fails. Released builds do not write DWG yet. Export DXF instead.

A DWG is refused as password-protected, or as R14 or older. Save it without a password, or in a newer DWG version, or as DXF.

"Archicad isn't open". Import from Archicad… found no Archicad running on this computer. Open your project in Archicad and click Try again, or save IFC from Archicad yourself. See Import from Archicad.

"Archicad needs the Tapir add-on". Archicad is running but Tapir is not installed in it. Install Tapir, restart Archicad and click Try again, or save IFC from Archicad yourself.

"Revit runs only on Windows" or "Open in Revit to export". Import from Revit… read the .rvt file but found no Revit to export it. Export IFC from Revit yourself (File > Export > IFC) and import that file. See Import from Revit.

A LAS or LAZ scan asks for its units. The file does not say them. Pick the units it was measured in.

A viewport's scale is refused. It is too large for the box. The message names the largest scale that fits.

An export or publish was cancelled or failed. A cancel, or a failure before any file is written, leaves the folder as it was. A failure while the files are being moved into place can leave some of them written. Check the folder, fix what the job's row says and run it again.

Still stuck

Help › View Telemetry Log… shows what Studio sent. If crash reports are on, a crash reaches Urbium with its details. When you contact us, say what you did, what you expected and the message you saw.