Griptape Vector Store Driver: Griptape Cloud
Your Griptape Cloud knowledge base, plugged straight into a workflow
- DRIVER
If you already use Griptape Cloud - the hosted platform from the same company that makes this node pack - you've got knowledge bases sitting there with your documents embedded and indexed. This driver is the handshake that lets a ComfyUI workflow read from them. Point it at a knowledge base ID, and every Query node that uses the agent's store starts searching the content you already curated in the cloud. For anyone not on Griptape Cloud, this node is meaningless - it's the one driver in the family with zero local value. The self-hosted story starts with the Local driver instead.
How it works
Unlike every other vector store driver in the pack, this one has no embedding_driver input at all - the source removes it outright. That's on purpose: Griptape Cloud handles embeddings server-side, inside your knowledge base. You don't need to pick a model or worry about the embedding-mismatch trap that bites the other drivers. The driver just needs to authenticate and know which knowledge base to talk to.
Three optional inputs, and they're all straightforward:
api_key_env_var(defaultGT_CLOUD_API_KEY) - the name of the environment variable holding your key, never the key itself. Set it in ComfyUI's Settings → Griptape section, or export it in your environment and it'll be picked up automatically.base_url(defaulthttps://cloud.griptape.ai) - leave it alone unless you're testing against a different endpoint.knowledge_base_id(default is a placeholder-looking string) - the ID of the knowledge base from your Griptape Cloud account. This is the one you must actually set. The default is not real.
Output is a single DRIVER of type VECTOR_STORE_DRIVER, which wires into the vector_store_driver slot of a Griptape Structure Config node, which feeds a Create Agent node. The Griptape Vector Store: Query node then reads the store off that agent and runs searches against your cloud knowledge base.
Where it fits
Honestly? This is the driver for people already living inside Griptape's ecosystem. If you've built knowledge bases on cloud.griptape.ai and want your ComfyUI agent to be grounded in them, it's a few clicks of wiring and it just works - no local embeddings, no DB schema to maintain. But if you're not a Griptape Cloud customer, skip it. There's nothing free-tier about this one: you need a GT_CLOUD_API_KEY from the cloud console, and your vectors live on their servers.
Install
Same as the rest of the pack - ComfyUI Manager, search "Griptape," INSTALL, restart. Manual route is git clone https://github.com/griptape-ai/ComfyUI-Griptape into ComfyUI/custom_nodes. The pack's requirements (griptape[all], python-dotenv) come along automatically, and its known friction point is the bundled torch build fighting ComfyUI's - the README's torch uninstall/reinstall fix is the standard cure. No model downloads for this node, but do grab your API key from cloud.griptape.ai before you start, or the driver will quietly have nothing to authenticate with.
Inputs (3)
| Name | Type | Default | Description |
|---|---|---|---|
| api_key_env_varopt | STRING | GT_CLOUD_API_KEY | Environment variable for the API key. Do not use your actual API key here. |
| base_urlopt | STRING | https://cloud.griptape.ai | Base URL for the Griptape Cloud service. |
| knowledge_base_idopt | STRING | 12345-abcde-1434 | ID of the knowledge base to use. |
Outputs (1)
| Name | Type | Description |
|---|---|---|
| DRIVER | VECTOR_STORE_DRIVER | — |