Burve Debug Vertex Auth
Vertex AI setup status, read from inside ComfyUI
- info
The Vertex AI twin of Burve Debug Gemini Key: a zero-input node that reports whether ComfyUI's environment has the three variables the Vertex version of the generator needs, and which ones are missing. If Burve Google Image Gen (Vertex AI) won't authenticate, this is where you start.
Vertex auth is genuinely more fiddly than an API key, because it's three separate things that have to all be true at once: a Google Cloud project, a location, and credentials (usually Application Default Credentials from gcloud auth application-default login). The debug node's whole value is separating those concerns. It doesn't try to authenticate - it just tells you which pieces of the config ComfyUI can actually see, so you're not debugging a permission error when the real problem is a missing environment variable.
How it works
Like its sibling, it forces a re-run every execution and inspects the process environment. It reports GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION as present/absent, and GOOGLE_APPLICATION_CREDENTIALS as yes/no. Then it explains what the report means, which is where people get lost:
GOOGLE_APPLICATION_CREDENTIALS present: nocan still be perfectly valid - ADC fromgcloud auth application-default logindoesn't need that variable set at all.GOOGLE_APPLICATION_CREDENTIALS present: yesis not enough by itself. The node still needs the project and location variables; a credentials file authenticates the SDK but doesn't pick a project or region for you.
It lists whichever required variables are missing, and the whole message also prints to the terminal in a box.
Inputs and outputs
- No inputs.
info- aSTRINGstatus message with the full breakdown; it's a workflow-output node, so it also lands in the output area.
The common failure patterns
- "Configuration is incomplete" -
GOOGLE_CLOUD_PROJECTand/orGOOGLE_CLOUD_LOCATIONmissing from the environment ComfyUI launched with. Set both and restart. - Variables set but node says missing - ComfyUI was launched from a different shell or a GUI context that doesn't inherit your profile. On macOS standalone builds use
launchctl setenvfor all three, then relaunch. On Windows,setxthem and open a fresh terminal. - Vars present, still auth errors - ADC is stale, expired, or the account lacks Vertex permissions. Re-run
gcloud auth application-default login.
The report also reminds you the node uses standard Vertex auth, not GEMINI_API_KEY - so if you set the API key and expected that to be enough, this is the nudge that it isn't. Install is standard pack fare: clone https://github.com/Burve/ComfyUI_Burve_Tools.git into custom_nodes or grab it via ComfyUI Manager, then restart.
Inputs (0)
No inputs
Outputs (1)
| Name | Type | Description |
|---|---|---|
| info | STRING | — |