The most powerful and modular diffusion model GUI, api and backend with a graph/nodes interface. The fastest local inference engine in the world.
Save Text Node (CORE-176) (#14102)
Yousef R. Gamaleldin94fa08223e61
diff --git a/comfy_execution/jobs.py b/comfy_execution/jobs.pyindex fa3ab0faf..f0ad59f86 100644--- a/comfy_execution/jobs.py+++ b/comfy_execution/jobs.py@@ -56,6 +56,9 @@ PREVIEWABLE_MEDIA_TYPES = frozenset({'images', 'video', 'audio', '3d', 'text'})# 3D file extensions for preview fallback (no dedicated media_type exists)THREE_D_EXTENSIONS = frozenset({'.obj', '.fbx', '.gltf', '.glb', '.usdz'})+# Text file extensions for preview fallback (the formats SaveText can produce)+TEXT_EXTENSIONS = frozenset({'.txt', '.md', '.json'})+def has_3d_extension(filename: str) -> bool:lower = filename.lower()@@ -143,9 +146,10 @@ def is_previewable(media_type: str, item: dict) -> bool:Maintains backwards compatibility with existing logic.Priority:- 1. media_type is 'images', 'video', 'audio', or '3d'+ 1. media_type is 'images', 'video', 'audio', '3d', or 'text'2. format field starts with 'video/' or 'audio/'3. filename has a 3D extension (.obj, .fbx, .gltf, .glb, .usdz)+ 4. filename has a text extension (.txt, .md, .json, ...)"""if media_type in PREVIEWABLE_MEDIA_TYPES:return True@@ -156,10 +160,12 @@ def is_previewable(media_type: str, item: dict) -> bool:if fmt and (fmt.startswith('video/') or fmt.startswith('audio/')):return True- # Check for 3D files by extension+ # Check for 3D and text files by extensionfilename = item.get('filename', '').lower()if any(filename.endswith(ext) for ext in THREE_D_EXTENSIONS):return True+ if any(filename.endswith(ext) for ext in TEXT_EXTENSIONS):+ return Truereturn False@@ -255,6 +261,10 @@ def get_outputs_summary(outputs: dict) -> tuple[int, Optional[dict]]:Preview priority (matching frontend):1. type="output" with previewable media2. Any previewable media++ Text content entries (strings under 'text') are preview-only metadata,+ matching the frontend's METADATA_KEYS: they can serve as the fallback+ preview but are not counted as outputs."""count = 0preview_output = None@@ -275,7 +285,6 @@ def get_outputs_summary(outputs: dict) -> tuple[int, Optional[dict]]:if normalized is None:# Not a 3D file string — check for text previewif media_type == 'text':- count += 1if preview_output is None:if isinstance(item, tuple):text_value = item[0] if item else ''diff --git a/comfy_extras/nodes_text.py b/comfy_extras/nodes_text.pynew file mode 100644index 000000000..a485f5df8--- /dev/null+++ b/comfy_extras/nodes_text.py@@ -0,0 +1,71 @@+import os+import json+from typing_extensions import override+from comfy_api.latest import io, ComfyExtension, ui+import folder_paths+++class SaveTextNode(io.ComfyNode):+ """Save text content to .txt, .md, or .json."""++ @classmethod+ def define_schema(cls):+ return io.Schema(+ node_id="SaveText",+ search_aliases=["save text", "write text", "export text"],+ display_name="Save Text",+ category="text",+ description="Save text content to a file in the output directory.",+ inputs=[+ io.String.Input("text", force_input=True),+ io.String.Input("filename_prefix", default="ComfyUI"),+ io.Combo.Input("format", options=["txt", "md", "json"], default="txt"),+ ],+ outputs=[io.String.Output(display_name="text")],+ is_output_node=True,+ )++ @classmethod+ def execute(cls, text, filename_prefix, format):+ full_output_folder, filename, counter, subfolder, filename_prefix = folder_paths.get_save_image_path(+ filename_prefix,+ folder_paths.get_output_directory(),+ 1,+ 1,+ )++ file = f"{filename}_{counter:05}.{format}"+ filepath = os.path.join(full_output_folder, file)++ if format == "json":+ # tries to pretty print otherwise saves normally+ try:+ data = json.loads(text)+ with open(filepath, "w", encoding="utf-8") as f:+ json.dump(data, f, indent=2, ensure_ascii=False)+ except json.JSONDecodeError:+ with open(filepath, "w", encoding="utf-8") as f:+ f.write(text)+ else:+ with open(filepath, "w", encoding="utf-8") as f:+ f.write(text)++ return io.NodeOutput(+ text,+ ui={+ "text": (text,),+ "files": [+ ui.SavedResult(file, subfolder, io.FolderType.output)+ ]+ }+ )++class TextExtension(ComfyExtension):+ @override+ async def get_node_list(self) -> list[type[io.ComfyNode]]:+ return [+ SaveTextNode+ ]++async def comfy_entrypoint() -> TextExtension:+ return TextExtension()diff --git a/nodes.py b/nodes.pyindex 474e188fe..31602e582 100644--- a/nodes.py+++ b/nodes.py@@ -2504,6 +2504,7 @@ async def init_builtin_extra_nodes():"nodes_triposplat.py","nodes_depth_anything_3.py","nodes_seed.py",+ "nodes_text.py",]import_failed = []