ComfyUI Extension: Runware.ai ComfyUI Inference API Integration

Authored by Runware

Created

Updated

114 stars

Runware Inference API Integration for ComfyUI (No GPU Required).

README

ComfyUI-Runware Integration ๐Ÿš€

Welcome to ComfyUI-Runware! ๐ŸŒŸ This is the official integration for Runware, bringing you the power of inference-as-a-service directly into ComfyUI!

๐ŸŒŸ What is ComfyUI-Runware?

Imagine creating stunning images or videos, refining details, or even removing backgroundsโ€”all without needing a powerful GPU. With Runware, all the heavy lifting happens on our servers. No GPU? No problem! ๐Ÿ–ฅ๏ธ๐Ÿ’จ

This integration adds a suite of custom nodes to ComfyUI, allowing you to:

  • Perform advanced image inference tasks, including image generation and editing with powerful models.
  • Utilize PhotoMaker V2 pipelines
  • Leverage cutting-edge models like Flux .1 Kontext Pro and Flux .1 Kontext Max for superior image generation and editing.
  • Upscale images
  • Remove backgrounds
  • Leverage specialized models and LoRAs
  • Use your custom uploaded models and LoRAs

... and so much more! Letโ€™s make your workflows seamless and efficient with Runware. ๐Ÿ–Œ๏ธโœจ


๐Ÿ“– Table of Contents

  1. Introduction
  2. Installation
  3. Node Features
  4. Support & Community

Hereโ€™s a sneak peek of the ComfyUI-Runware nodes in action:

Screenshot


๐Ÿ”ง Installation

Step 1: Install ComfyUI

First, ensure you have ComfyUI installed. You can follow the pre-built package guide or the manual installation guide.

Make sure your system meets these requirements:

  • Python 3.10+
  • ComfyUI installed

Step 2: Install ComfyUI-Runware

You have two options to install this integration:

Option 1: Using ComfyUI Manager (Recommended)

First, ensure you have the ComfyUI-Manager custom node installed. If you don't have it or are using the beta ComfyUI desktop version, follow the instructions on this GitHub Repo.

After installing ComfyUI-Manager, open it and click on "Custom Nodes Manager". Search for "Runware" or "Runware.ai" and then click on install or update. Finally, restart your ComfyUI. โœจ

Option 2: Manual Installation

  1. Navigate to the custom nodes directory:

    cd custom_nodes
    
  2. Clone the repository:

    git clone https://github.com/Runware/ComfyUI-Runware.git
    
  3. Navigate to the repository folder:

    cd ComfyUI-Runware
    
  4. Install dependencies:

    pip install -r requirements.txt
    

Step 3: Run ComfyUI

Install latest ComfyUI frontend package

pip install -U comfyui-frontend-package

Start ComfyUI with the following command:

python main.py

Optional: CPU-Only Mode

If you want to run ComfyUI without a GPU, add the --cpu flag:

python main.py --cpu

Step 4: Explore Workflows

Inside the ComfyUI-Runware custom node folder, youโ€™ll find a workflows folder with pre-made workflows to get you started! ๐Ÿš€


๐Ÿงฉ Node Features

Here's a breakdown of the amazing nodes included in this integration:

  • Runware API Manager: Set or change your API keys, adjust the max connection timeout, adjust the image output quality and format, and enable or disable image caching directly in ComfyUIโ€”no need to edit config files manually! ๐Ÿ”‘

  • Runware Image Inference: Perform advanced tasks like inpainting, outpainting, and more ๐ŸŽจ

  • Runware PhotoMakerV2: Create consistent identities with our photomaker pipeline. ๐Ÿ–ผ๏ธ

  • Runware Image Upscale: Upscale your images up to 4x. ๐Ÿ”

  • Runware Background Removal: Effortlessly remove image backgrounds. ๐Ÿงน

  • Runware LoRA: Search and select LoRAs to enhance your workflow. ๐Ÿ“‚

  • Runware Model: Choose specific models to connect with image inference. ๐Ÿค–

  • Runware ControlNet: Guide your image generation with ControlNet and guide images. ๐Ÿ—บ๏ธ

  • Runware Refiner: Refine your images with advanced tools. โœจ

  • Runware LoRA Combine: Combine up to 3 LoRAs together. ๐Ÿ”—

  • Runware ControlNet Combine: Combine multiple ControlNets for complex workflows. ๐Ÿงฉ

  • Runware Image Masking: Automatically mask elements like faces, hands, and more. ๐Ÿ–Œ๏ธ

  • Runware ControlNet Preprocessor: Preprocess images before using them as guide images in ControlNet. ๐Ÿ”„

  • Runware VAE: Search and connect a VAE to Image inference. ๐Ÿ–ผ๏ธ

  • Runware Embedding: Search and connect Embedding to image inference. ๐Ÿงฉ

  • Runware Embedding Combine: Combine multiple embeddings together. ๐Ÿ”—

  • Runware Image Caption: Generate descriptive text from images for further workflow integration. ๐Ÿ–ผ๏ธ

  • Runware IPAdapter: Use reference images to guide the style and content of generated images. ๐Ÿ–Œ๏ธ

  • Runware IPAdapters Combine: Combine multiple IP-Adapter inputs for sophisticated image conditioning. ๐Ÿ”—

  • Runware Video Inference: Generate videos from text prompts using advanced AI models with support for frame images and reference images. ๐ŸŽฌ

  • Runware Frame Images: Configure keyframe images with precise positioning control for video generation. ๐Ÿ–ผ๏ธโžก๏ธ๐ŸŽฅ

  • Runware Reference Images: Provide reference images for overall visual guidance in video generation. ๐Ÿ–ผ๏ธ

  • Runware Pixverse Provider Settings: Configure Pixverse-specific settings with effect, style, motion, and sound options. ๐ŸŽฌ

  • Runware OpenAI Provider Settings: Configure OpenAI-specific settings with quality, background, and style options. ๐Ÿค–


๐Ÿค Support & Community

This is the official Runware integration, maintained by Runware Inc. Weโ€™re here to help you every step of the way! ๐Ÿ’ฌ

Join our community on Discord for support, updates, and to connect with fellow creators: Runware Discord ๐ŸŽ‰


Thank you for using ComfyUI-Runware! Letโ€™s create something amazing together. ๐ŸŒŸ