fn_registry/python/functions/ml/comfyui_fetch_output_image.md

name, kind, lang, domain, version, purity, signature, description, tags, uses_functions, uses_types, returns, returns_optional, error_type, imports, params, output, tested, tests, test_file_path, file_path

name	kind	lang	domain	version	purity	signature	description	tags	uses_functions	uses_types	returns	returns_optional	error_type	imports	params	output	tested	tests	test_file_path	file_path
comfyui_fetch_output_image	function	py	ml	1.0.0	impure	def comfyui_fetch_output_image(filename: str, *, subfolder: str = "", type_: str = "output", server: str = "127.0.0.1:8188", dest_dir: str = ".", timeout: float = 60.0) -> dict	Descarga un PNG generado por ComfyUI via GET /view?filename=&subfolder=&type= a disco local. comfyui_wait_result solo devuelve metadata (filename/subfolder/type); esta funcion baja el archivo real. Impura: HTTP GET + escritura en disco, solo stdlib.	comfyui ml image-generation download workflow				false	error_go_core		name desc filename Nombre del archivo en el servidor (ej. 'comfy_00001_.png'), tal como lo reporta comfyui_wait_result en outputs[node].images[].filename. name desc subfolder Subcarpeta dentro de la carpeta del servidor (vacia por defecto). keyword-only. name desc type_ Tipo de carpeta del servidor: 'output', 'temp' o 'input'. keyword-only. name desc server host:port del servidor ComfyUI sin esquema. keyword-only. name desc dest_dir Directorio local donde guardar la imagen; se crea si no existe. keyword-only. name desc timeout Timeout de la peticion HTTP en segundos. keyword-only.	dict {ok, path, size_bytes, error}. path = ruta local del PNG guardado, size_bytes = bytes descargados. Si falla, ok=False y error explica (HTTP/conexion/escritura).	false			python/functions/ml/comfyui_fetch_output_image.py

Ejemplo

import sys, os
sys.path.insert(0, os.path.join(os.environ["HOME"], "fn_registry", "python", "functions"))
from ml.comfyui_fetch_output_image import comfyui_fetch_output_image

# Tras comfyui_submit_workflow + comfyui_wait_result, baja el PNG al disco
res = comfyui_fetch_output_image("comfy_00001_.png", dest_dir="/tmp/comfy_out")
# res == {"ok": True, "path": "/tmp/comfy_out/comfy_00001_.png", "size_bytes": 372027, "error": ""}

Lánzalo con el python del venv (import de arriba o heredoc). Nota: ./fn run directo no aplica porque la firma usa * (keyword-only), no soportado por el generador de runner de fn run.

Cuando usarla

Despues de generar una imagen (submit + wait), cuando necesites el PNG real en disco (no solo su nombre): para abrirlo, mostrarlo, post-procesarlo o moverlo a un vault. Toma filename/subfolder/type directo de la entrada images[] que devuelve comfyui_wait_result por nodo SaveImage.

Gotchas

• Impura: hace HTTP GET al servidor y escribe en disco. Requiere el servidor vivo.
• type_ debe coincidir con la carpeta real: SaveImage escribe en "output", PreviewImage en "temp". Si pasas el type equivocado, el servidor responde 404.
• El nombre local es basename(filename) dentro de dest_dir (no recrea la estructura de subfolder en local).
• No reintenta: si el servidor esta reiniciandose, devuelve error de conexion; reintenta tu desde el caller.