Skip to content

gaia-emr dashboard serves a bare API response when the frontend isn't built; EMR guide doesn't document npm build step #1080

Description

@itomek

gaia-emr dashboard is documented to launch a desktop/web dashboard. On a fresh developer install, it silently serves an API-only response in the browser because the frontend hasn't been built. The response body itself says the frontend isn't built.

Reproduction

PS> gaia-emr dashboard
# Browser opens to http://localhost:<port>/ and shows:
{"message":"EMR Dashboard API is running","frontend":"not built (run npm build in dashboard/frontend)","api_docs":"/docs"}

Two problems

  1. Docs gapdocs/guides/emr.mdx doesn't tell the user to run npm build in dashboard/frontend/ before launching the dashboard. Same shape as Use public Lemonade hybrid installer #2's missing-extras pattern.
  2. CLI UX bug — the command knows the frontend isn't built (the message says so) but launches anyway. It should either build on demand, fail loud with the build instruction, or at minimum surface the missing-frontend state without saying "is running."

Also on the same guide: docs/guides/emr.mdx links to https://github.com/amd/gaia/tree/main/src/gaia/agents/emr for "sample intake forms," but that directory contains no intake forms.

Fix

Docs: add a Build-the-frontend step (or fold into #6's Prerequisites template). CLI: build the frontend automatically on first launch, OR raise a clear error referencing the build step. Locate or remove the sample intake forms link.

Severity rationale

P1 — documented feature is silently non-functional on a clean install.

Metadata

Metadata

Assignees

No one assigned

    Labels

    bugSomething isn't workingcliCLI changesdocumentationDocumentation changesdomain:multimodalVoice (ASR/TTS), Vision (VLM), Image gen (SD), CUAp1medium priority

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions