Agnes-AI Image

Let's be clear about what this node is, because the name oversells it: Agnes-AI Image doesn't run a model. It packages your prompt (and up to four images) into an HTTP request, sends it to Agnes AI's cloud API, and drops whatever comes back into your graph as a normal IMAGE tensor. Zero VRAM, zero pip install, zero credits. On paper that's a generator node you can use while your own GPU is busy - or if you don't have one at all.

How it works

Under the hood it's one POST to https://apihub.agnes-ai.com/v1/images/generations with your Bearer key. The quality widget maps to a side length - 1K = 1024, 2K = 2048, 4K = 4096 - and aspect_ratio turns that into a width×height rounded to a multiple of 8. Connect any of the four image inputs and it switches from text2img to img2img: each reference image gets base64-encoded as a PNG data URI and shipped along. Leave the prompt empty with images attached and it defaults to merging them "into one cohesive composition," which is a nicer description than most merge prompts you'd write yourself. The result comes back as a URL or raw base64, gets downloaded into ComfyUI's temp folder, and lands in the images output as a torch tensor.

The inputs that matter

You'll set exactly two things most of the time:

• prompt - multiline; can stay empty if you've wired in reference images.
• quality - 1K, 2K, or 4K. Start at 1K to check that the call works; 4K is slower and there's no point paying cloud render time for a draft.

aspect_ratio defaults to auto (which just means 1:1 for text2img, or the source image's shape for img2img). The optional image, image_2, image_3, image_4 inputs are your reference stack - wire them from a Load Image node. The single output, images (IMAGE), plugs into Preview Image, Save Image, or anything else that expects a tensor. The default model is agnes-image-2.1-flash, switchable in Settings.

Installing it

ComfyUI Manager, search Agnes-AI, install, restart. Or the manual way:

cd ComfyUI/custom_nodes
git clone https://github.com/1038lab/ComfyUI-Agnes-AI

Then restart. There's no requirements.txt to satisfy - the pack leans on Python stdlib plus PIL and torch, which ComfyUI already has. That's the one genuinely nice thing about it. You do need a free API key from platform.agnes-ai.com, entered under ComfyUI Settings (⚙️) → search "Agnes-AI", or set the AGNES_API_KEY environment variable. Comma-separate several keys if you want round-robin load balancing.

Gotchas

• Old tutorials show an AgnesConfig node for the API key. That was v1.0. Since v1.1.0 (July 2026) everything moved into the Settings panel - the config node is gone.
• The node raises "API key required - set it in ComfyUI Settings Panel → Agnes-AI" if the key's missing, which is the #1 first-run error.
• Image-to-image 400 errors were a real bug in 1.0.0 and got fixed in 1.1.0, so if you're on an old clone, update.
• Every generation is a cloud round-trip, so first result takes a while and your prompt and reference images leave your machine. The model and its content filters are Agnes's, not yours.

The honest caveat

This is an API-wrapper node, and that category has already been weaponized once in this ecosystem - the LLMVISION incident shipped credential-stealing malware disguised as exactly this kind of convenience. Agnes AI is brand new; its launch thread on r/comfyui got essentially no engagement, including the memorable reply "the point of comfyui is to not do this." None of that means it's malicious. It means you should glance at the source before you paste a key into a fresh cloud platform. If you just want a quick draft generator while your GPU renders something else, this is fine. For anything you actually care about, keep it local.