<p align="center"> <a href="https://ecohash.com?utm_source=github&utm_medium=referral&utm_campaign=api-comfyui-always-on&utm_content=readme.logo"><img src="https://raw.githubusercontent.com/ecohash-ai/ComfyUI-EcoHash/main/assets/ecohash-logo.png" width="280" alt="EcoHash"></a> </p> <h1 align="center">ComfyUI-EcoHash</h1> <p align="center">EcoHash nodes for ComfyUI — image generation & editing, LLM prompt tools, vision captioning, TTS and STT, powered by the EcoHash API.</p> <p align="center"> <img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT"> <a href="https://registry.comfy.org/nodes/comfyui-ecohash"><img src="https://img.shields.io/badge/Comfy%20Registry-comfyui--ecohash-1a1a1a" alt="Comfy Registry"></a> <a href="https://docs.ecohash.com?utm_source=github&utm_medium=referral&utm_campaign=api-comfyui-always-on&utm_content=readme.docs-badge"><img src="https://img.shields.io/badge/documentation-6D28D9" alt="Documentation"></a> <a href="https://x.com/ecohashdev"><img src="https://img.shields.io/badge/X-@ecohashdev-000000?logo=x&logoColor=white" alt="X"></a> <a href="https://huggingface.co/ecohash-ai"><img src="https://img.shields.io/badge/%F0%9F%A4%97%20Hugging%20Face-ecohash--ai-FFD21E" alt="Hugging Face"></a> </p>

What is EcoHash

EcoHash runs an NVIDIA RTX PRO 6000 GPU cloud and, on top of it, an OpenAI-compatible inference API for open models: image generation and editing, LLM chat, vision-language description, text-to-speech, and speech-to-text. This package adds six ComfyUI nodes that call that API directly from your workflows — no local GPU or model download required for these nodes.

Need a whole GPU instead of an API call? The same account rents RTX PRO 6000 Blackwell instances (96 GB VRAM) by the hour, so you can run a full ComfyUI stack with local checkpoints alongside these nodes. See the GPU cloud docs.

Sign up at ecohash.com to get an API key. New accounts receive a small free starter credit so you can try the nodes before adding a payment method. Full docs live at docs.ecohash.com.

Install

Option A — ComfyUI-Manager

Open ComfyUI-Manager, search for EcoHash, and install "ComfyUI-EcoHash".

Option B — git clone

cd ComfyUI/custom_nodes
git clone https://github.com/ecohash-ai/ComfyUI-EcoHash.git
cd ComfyUI-EcoHash
pip install -r requirements.txt

Restart ComfyUI after installing.

Set your API key

This package deliberately has no API-key input widget on any node. Workflow JSON files are frequently shared, screenshotted, or committed to git, and a key typed into a node widget would be saved right there in plain text for anyone who opens the file. Instead, the key is read once at request time from outside the workflow graph, using one of:

Environment variable — set ECOHASH_API_KEY in the environment ComfyUI runs in, e.g.:
```
export ECOHASH_API_KEY="eco_..."
```
config.ini — copy config.ini.example (in this folder) to config.ini and paste your key:
```
[ecohash]
api_key = eco_YOUR_KEY_HERE
```
config.ini is git-ignored by this repo so it won't be committed by accident.

Get or manage your key in the API keys guide.

Never paste your API key into a node widget, a workflow JSON, or a screenshot. Any key value embedded in a saved workflow is exposed to everyone who receives that file.

Nodes

| Node | Inputs | Outputs | Purpose | |---|---|---|---| | EcoHash Image Generate | model (live catalog, image models), prompt (string), size (1024x1024/1024x768/768x1024/768x768/512x512), steps (int, 0 = model default), seed (int, -1 = random) | IMAGE | Generate an image from a text prompt. | | EcoHash Image Edit | image (IMAGE), model (catalog models that support image edit), prompt (string), size (auto + preset sizes; auto keeps the source image's dimensions) | IMAGE | Edit/transform an existing image with a text instruction. | | EcoHash LLM | model (catalog llm/llm_vision models), mode (chat / prompt_enhance / translate_to_english / custom), text (string), system_prompt (string, used only when mode = custom), temperature (float, 0–2), max_tokens (int) | STRING | Run a chat completion. prompt_enhance rewrites a rough idea into a detailed image-generation prompt; translate_to_english converts non-English text; useful chained before an Image Generate node. | | EcoHash VLM Describe | image (IMAGE), model (catalog llm_vision models), prompt (string, defaults to a detailed-description instruction), max_tokens (int) | STRING | Describe an input image in detail with a vision-language model — handy for turning an existing image into a prompt for regeneration or variation. | | EcoHash TTS | model (catalog speech_tts models), text (string), voice (string, e.g. af_bella), speed (float, 0.5–2.0) | AUDIO | Synthesize speech from text. | | EcoHash STT | audio (AUDIO), model (catalog speech_stt models), language (string, ISO-639-1 code, empty = auto-detect) | STRING | Transcribe speech audio to text. |

All model dropdowns are populated live from the EcoHash model catalog at graph-build time, so the exact list of available models will change as EcoHash adds or retires models — check the model catalog for the current lineup. If the catalog can't be reached, nodes fall back to a packaged snapshot so the graph still loads.

ComfyUI caches node outputs — re-queueing an identical graph returns cached results without a new API call; change any input (e.g. seed) to force a fresh call.

Example workflows

Ready-to-load example workflows (text-to-image, prompt-enhance-then-generate, describe-and-regenerate, and TTS voiceover) live in example_workflows/. The node chains they use were exercised live against the real EcoHash API — see tests/SMOKE_RESULTS.md — and the workflow JSON files themselves were validated against a live ComfyUI instance's node schema; see that folder's README for exactly what was and wasn't verified (a literal browser load/click-Queue pass was not performed, since this was done headlessly).

Pricing

EcoHash is metered, pay-as-you-go usage on top of your free starter credit. See current plans and per-model pricing at the billing docs.

Support

Bugs and feature requests: GitHub Issues (this repo)
Account or billing questions: the EcoLink console support chat — EcoHash support

中文说明

EcoHash 提供 NVIDIA RTX PRO 6000 GPU 云，以及构建其上的 OpenAI 兼容推理 API。ComfyUI-EcoHash 为 ComfyUI 提供 6 个节点，通过该 API 调用图像生成/编辑、LLM 对话、图像描述（VLM）、文本转语音（TTS）和语音转文本（STT），无需本地 GPU 或下载模型。

GPU 云：同一个账号也可按小时租用 RTX PRO 6000 Blackwell 实例（96 GB 显存），用于运行带本地模型的完整 ComfyUI 环境，详见 GPU 云文档。

安装：在 ComfyUI-Manager 中搜索 "EcoHash" 安装，或将本仓库 git clone 到 ComfyUI/custom_nodes/ 目录下，然后 pip install -r requirements.txt。

配置密钥：本插件的节点上没有任何 API Key 输入框——因为工作流 JSON 经常被分享、截图或提交到仓库，写在节点里的密钥会随之泄露。请改用环境变量 ECOHASH_API_KEY，或将 config.ini.example 复制为 config.ini 并填入密钥。切勿将密钥粘贴到节点、工作流文件或截图中。

价格：按量计费，详见计费文档。

支持：在本仓库的 GitHub Issues 提交问题，或通过 EcoLink 控制台的在线支持聊天获取帮助：支持页面。