JoyCaption Nodes

By fpgaminerView on GitHub →

Nodes for running the JoyCaption image captioner VLM.

How much VRAM does JoyCaption Nodes require?

Direct Answer: The ComfyUI node JoyCaption Nodes requires a minimum base VRAM of 128MB and is optimized for GPUs with at least 4GB of VRAM. Low VRAM mode is fully supported for resource-constrained setups.

High (2-4GB)
Base VRAM:
128MB (0.1GB)
Recommended GPU:
4GB+ VRAM
Low VRAM Mode:
✓ Supported
Estimation Confidence:
MEDIUM

Interactive VRAM Compatibility Estimator

Estimated Total VRAM: 3.00 GBTarget: 8 GB
✅ Comfortable Fit

Your GPU has plenty of headroom. You can run this node safely with your active configurations!

Deploy on High-Performance GPUs

Need more VRAM to run ComfyUI with this node? Rent low-cost, high-performance GPUs on Vast.ai instantly.

🚀 Deploy on Vast.ai

Deploy on Cloud GPUs

Need more VRAM to run ComfyUI with this node? Rent low-cost, high-performance cloud GPUs on RunPod instantly.

🚀 Deploy on RunPod

What Python packages are required for JoyCaption Nodes?

Direct Answer: Running JoyCaption Nodes requires installing the following Python package dependencies: accelerate, bitsandbytes, huggingface-hub, torch, torchvision, transformers>=4.51. Ensure your ComfyUI environment has these packages active before launching.

requirements.txt
accelerate
bitsandbytes
huggingface-hub
torch
torchvision
transformers>=4.51

Interactive Setup & Dependency Resolver

Operating System:
Environment Type:
Run this terminal command in your ComfyUI root folder:
# Loading command...

Related Custom Nodes

The following custom nodes run in the same PyTorch / CUDA environment and share similar categories or workflows:

AITocha Vision
by aitocha128MB VRAM
AI_Text_Comfyui
by Zch6111256MB VRAM
AK XZ Axis (XY for any KSampler)
by akawana256MB VRAM
ArtyClaw Comfy Nodes
by artyclaw256MB VRAM

Frequently Asked Questions

How much VRAM does JoyCaption Nodes require?

JoyCaption Nodes requires a minimum of 128MB (0.1GB) of VRAM for base operation. For optimal performance, a GPU with at least 4GB of VRAM is recommended. This node supports low VRAM mode for resource-constrained setups.

Can I run JoyCaption Nodes on an RTX 3060, RTX 4070, or RTX 4090?

✅ RTX 3060 (12GB): Yes, fully compatible with 10.7GB headroom. ✅ RTX 4070 (12GB): Yes, fully compatible with 10.7GB headroom. ✅ RTX 4070 Ti (16GB): Yes, fully compatible with 14.3GB headroom. ✅ RTX 4090 (24GB): Yes, fully compatible with 21.5GB headroom

What PyTorch version does JoyCaption Nodes need?

JoyCaption Nodes requires the following PyTorch-related packages: torch, torchvision. Ensure your ComfyUI environment has these installed. Ensure your PyTorch installation matches your CUDA version (use torch.version.cuda to check).

What Python packages are required for JoyCaption Nodes?

To run JoyCaption Nodes, you need to install: accelerate, bitsandbytes, huggingface-hub, torch, torchvision, transformers>=4.51. You can install these using pip or add them to your requirements.txt file.

How can I reduce VRAM usage when running JoyCaption Nodes?

JoyCaption Nodes supports low VRAM mode. To reduce memory usage: (1) Enable --lowvram or --medvram flags in ComfyUI, (2) Reduce batch size to 1, (3) Use fp16 or fp8 precision if supported, (4) Close other GPU applications.

How do I install JoyCaption Nodes in ComfyUI?

To install JoyCaption Nodes: (1) Navigate to your ComfyUI/custom_nodes directory, (2) Clone the repository: git clone https://github.com/fpgaminer/joycaption_comfyui, (3) Install dependencies: pip install -r requirements.txt (if present), (4) Restart ComfyUI. Alternatively, use ComfyUI Manager for one-click installation.