Nodes/ComfyUI Griptape Nodes/Griptape Vector Store Driver: Griptape Cloud
ComfyUI Node

Griptape Vector Store Driver: Griptape Cloud

Your Griptape Cloud knowledge base, plugged straight into a workflow

By griptape-ai·Created 2 years ago·Updated about a year ago· 238
Griptape Vector Store Driver: Griptape Cloud
    • DRIVER
    api_key_env_varGT_CLOUD_API_KEY
    base_urlhttps://cloud.griptape.ai
    knowledge_base_id12345-abcde-1434

    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 (default GT_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 (default https://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.

    CategoryGriptape/Agent Drivers/Vector Store

    Inputs (3)

    NameTypeDefaultDescription
    api_key_env_varoptSTRINGGT_CLOUD_API_KEYEnvironment variable for the API key. Do not use your actual API key here.
    base_urloptSTRINGhttps://cloud.griptape.aiBase URL for the Griptape Cloud service.
    knowledge_base_idoptSTRING12345-abcde-1434ID of the knowledge base to use.

    Outputs (1)

    NameTypeDescription
    DRIVERVECTOR_STORE_DRIVER