> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Import/Create Workflows

> Learn how to bring existing ComfyUI workflows into FlowScale AI or create new ones from scratch

import ImportWorkflowsTroubleshooting from '/snippets/troubleshooting/import-workflows-basic.mdx';

Import your ComfyUI workflows into FlowScale AI for team collaboration and production deployment. This guide covers importing existing workflows and creating new ones in the cloud environment.

<Note>
  **New to FlowScale AI?** You'll need to [create a project first](/getting-started/glossary/projects). Think of projects as collaborative workspaces where your team's workflows live and evolve together.
</Note>

## Import Existing Workflows

### Step-by-Step Import Process

<Steps>
  <Step title="Click Import Workflow">
    In your FlowScale AI project dashboard, click the **"Import Workflow"** button

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_import_workflow_button.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=0b93fb34bbb08de0ecfe6912e313b9ef" alt="Clean FlowScale project dashboard interface showing the main workspace with a prominently highlighted Import Workflow button in the top-right area. Shows project name, navigation sidebar, and empty workflow list state with clear call-to-action styling" width="1918" height="865" data-path="images/glossary/comfyui_import_workflow_button.png" />
    </Frame>
  </Step>

  <Step title="Upload Workflow JSON">
    Select and upload your ComfyUI workflow JSON file (exported from ComfyUI using the "Save" option)

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_import_options.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=eecf146ce93275a60ab000decea457b8" alt="Modal dialog overlay showing the workflow import interface with drag-and-drop file upload area, supported file format information (.json), and clear upload instructions. Includes progress indicator and file validation messaging" width="1918" height="865" data-path="images/glossary/comfyui_import_options.png" />
    </Frame>
  </Step>

  <Step title="Review Custom Nodes">
    FlowScale AI automatically detects required custom nodes and displays them for review

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_custom_nodes.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=6f5a6bae8a6f809da8d282f2718cf546" alt="Interface showing automated detection of custom nodes with a list view displaying node names, sources (GitHub URLs), and status indicators (detected/verified/missing). Includes resolution options and dependency management tools" width="1918" height="867" data-path="images/glossary/comfyui_custom_nodes.png" />
    </Frame>
  </Step>

  <Step title="Resolve Conflicts">
    If conflicting nodes are detected, select the correct versions that your workflow actually uses

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_conflicting_nodes.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=aafbdbafea0c92fe8e363745e4218a0a" alt="Detailed conflict resolution interface showing side-by-side comparison of conflicting node versions with recommendation badges, compatibility notes, and user selection options. Includes version numbers and source information" width="1918" height="867" data-path="images/glossary/comfyui_conflicting_nodes.png" />
    </Frame>
  </Step>

  <Step title="Complete Setup">
    Click Confirm to add all necessary configuration for your workflow, and your imported project is ready to use!
  </Step>
</Steps>

<Frame>
  <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_project_import_indicators.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=9da79149accb867fe51c8ee0ed868ed1" alt="Step-by-step visual flow showing the entire import process from file upload through conflict resolution to successful integration, with progress indicators and completion confirmation" width="1918" height="862" data-path="images/glossary/comfyui_project_import_indicators.png" />
</Frame>

### Supported Import Format

FlowScale AI imports **Workflow JSON** files from ComfyUI's "Save" function.

<Warning>
  **File Format Matters:** Only use JSON files exported directly from ComfyUI's Save function. Other export formats or manually edited files may cause import issues or lost functionality.
</Warning>

## Accessing ComfyUI Workspace

Pods are cloud-hosted ComfyUI instances that provide on-demand access to GPU resources.

### Launch Process

<Steps>
  <Step title="Start ComfyUI">
    Click **"Start ComfyUI"** button in your project

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_start_button.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=b3e5a9bfd50edb8b891cab74115053b7" alt="Project interface showing the prominent Start ComfyUI button with pod status indicators and workspace access controls. Shows resource availability and startup options" width="1918" height="867" data-path="images/glossary/comfyui_start_button.png" />
    </Frame>
  </Step>

  <Step title="Select Pod">
    Choose the pod configuration for your ComfyUI instance from the modal

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_pod_config.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=72e8ec27339f7bab1796825645818921" alt="Modal dialog displaying available GPU pod options with detailed specifications (T4, A10G, L4, L40S, A100 40GB, A100 80GB, H100, H200, B200), pricing information, resource availability status, and performance recommendations for different workflow types" width="1918" height="872" data-path="images/glossary/comfyui_pod_config.png" />
    </Frame>
  </Step>

  <Step title="Monitor Installation">
    While ComfyUI starts, custom nodes are installed automatically. View progress in System Logs

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_system_logs.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=1be262817b55b9d225eb39da5467c0c8" alt="Console/terminal interface showing real-time startup logs with custom node installation progress, dependency resolution status, and system initialization messages. Includes timestamps and log level indicators" width="1918" height="868" data-path="images/glossary/comfyui_system_logs.png" />
    </Frame>
  </Step>

  <Step title="Workspace Ready">
    Once started, you'll see the ComfyUI workspace in CPU mode

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_default_state.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=08e5b0f7a2fcc7bb9790d8bbf2725c6c" alt="Full ComfyUI interface in CPU mode showing the node-based visual programming environment with sample workflow loaded, CPU mode indicator in top bar, and workspace tools/panels visible" width="1918" height="862" data-path="images/glossary/comfyui_default_state.png" />
    </Frame>
  </Step>
</Steps>

### CPU vs GPU Mode

<Tabs>
  <Tab title="CPU Mode (Default)">
    **For workflow editing:**

    * Connecting nodes and adjusting parameters
    * Low cost for workflow development
    * Use for planning and structure building
  </Tab>

  <Tab title="GPU Mode">
    **For workflow execution:**

    * Running inference and testing outputs
    * Higher cost but enterprise GPU performance
    * Use only when generating results
  </Tab>
</Tabs>

<Tip>
  **Cost Optimization**: Always use CPU mode for editing workflows and only switch to GPU mode when you need to execute them. This prevents unnecessary credit burn.
</Tip>

<Frame>
  <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_gpu_switch_button.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=e73dd9d31427c0b0008d1be959ccfc60" alt="Close-up of the ComfyUI actions bar highlighting the CPU/GPU mode toggle switch with clear visual states, resource usage indicators, and cost implications display" width="610" height="157" data-path="images/glossary/comfyui_gpu_switch_button.png" />
</Frame>

## Model Management

FlowScale AI provides centralized model management with public and private model libraries for team sharing.

### Model Setup Process

<Steps>
  <Step title="Start ComfyUI Workspace">
    Launch your ComfyUI instance in your project
  </Step>

  <Step title="Test Workflow">
    Run your workflow once to identify missing models (you'll see error messages)

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_missing_nodes.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=7c57e7552e7abeb72a578d02994fa36d" alt="Error modal showing missing model notification with specific model names, suggested resolution actions, and links to model management tools. Clear error messaging with actionable next steps" width="1918" height="867" data-path="images/glossary/comfyui_missing_nodes.png" />
    </Frame>
  </Step>

  <Step title="Check Workflow Node Dropdowns for Public Models">
    Look for required models in the dropdown menus of the workflow nodes themselves. If models are available in the public library, they will appear in the relevant node dropdowns within your workflow

    <Tip>
      Models may appear under similar filenames—check carefully for variations or similar names.
    </Tip>

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_model_library.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=45f1a56c3d8b12e0c0e74e5cac0aeaed" alt="ComfyUI workflow node with expanded dropdown menu showing available models, model categories, and selection interface. Highlights newly added models and compatibility indicators" width="1918" height="868" data-path="images/glossary/comfyui_model_library.png" />
    </Frame>
  </Step>

  <Step title="Access Private Models">
    If models aren't found publicly, navigate to **Private Models** section

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_private_model_section.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=299243a5ee234e1ccffef0a0bbe2dbaa" alt="Dedicated models management page showing folder structure, uploaded models list, storage usage, and organization tools. Clean file browser-style interface with model metadata" width="1918" height="867" data-path="images/glossary/comfyui_private_model_section.png" />
    </Frame>
  </Step>

  <Step title="Create Model Folders">
    Create appropriate folder structure as required by ComfyUI or custom nodes

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/c3fz2QbstdPhv1Vg/images/glossary/comfyu_model_upload_file_structure.png?fit=max&auto=format&n=c3fz2QbstdPhv1Vg&q=85&s=5dfbca51ec447b92227b78defa9db8fd" alt="Modal dialog for creating new model folders with folder type selection (checkpoints, loras, vae, embeddings), naming conventions, and organizational structure options" width="1918" height="867" data-path="images/glossary/comfyu_model_upload_file_structure.png" />
    </Frame>
  </Step>

  <Step title="Upload Models">
    Click **"Upload Model"** and either search for models or provide download links

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_model_upload_options.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=c47d7f1858c01caa21932a12bf565f00" alt="Tabbed interface showing multiple upload methods such as file upload, URL download, and model search. Includes progress tracking, validation, and metadata extraction features" width="1918" height="868" data-path="images/glossary/comfyui_model_upload_options.png" />
    </Frame>
  </Step>

  <Step title="Refresh ComfyUI">
    After model download completes, refresh ComfyUI from the actions bar

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_restart_button.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=7922b8a16877575411706a49efbb10bb" alt="Actions bar with highlighted refresh button for reloading models and nodes, showing refresh state indicators and workspace synchronization status" width="1919" height="868" data-path="images/glossary/comfyui_restart_button.png" />
    </Frame>
  </Step>

  <Step title="Verify Model Availability">
    Check the workflow node dropdowns again to confirm the newly added models are now available for selection
  </Step>
</Steps>

### Model Sources

<CardGroup cols={3}>
  <Card title="Public Library" icon="globe">
    Pre-loaded models from Hugging Face, Civitai, and popular community sources
  </Card>

  <Card title="Private Upload" icon="upload">
    Custom models, fine-tuned checkpoints, and specialized LoRAs
  </Card>

  <Card title="URL Download" icon="link">
    Direct download from external sources using model URLs
  </Card>
</CardGroup>

### Folder Structure Guidelines

When creating folders for models, follow ComfyUI conventions:

* **Checkpoints**: `models/checkpoints/`
* **LoRAs**: `models/loras/`
* **VAE**: `models/vae/`
* **Custom nodes**: Check the node's GitHub repository for specific folder requirements

<Warning>
  For custom node models, always refer to the node's GitHub repository README for correct folder naming conventions.
</Warning>

## Creating New Workflows

Create workflows directly in FlowScale AI for immediate team collaboration and deployment readiness.

### Quick Start Method

<Steps>
  <Step title="Create New Workflow">
    Click **"Create New Workflow"** button in your project

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_create_workflow_button.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=5fb1c43b00e99758eadea20e268f0bf1" alt="Project dashboard with highlighted Create New Workflow button as alternative to importing, showing workflow templates and creation options" width="1919" height="866" data-path="images/glossary/comfyui_create_workflow_button.png" />
    </Frame>
  </Step>

  <Step title="Start with Basic Template">
    A basic text-to-image workflow loads automatically in the ComfyUI workspace

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_default_state.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=08e5b0f7a2fcc7bb9790d8bbf2725c6c" alt="A basic text-to-image workflow loads automatically in the ComfyUI workspace" width="1918" height="862" data-path="images/glossary/comfyui_default_state.png" />
    </Frame>
  </Step>

  <Step title="Customize Workflow">
    Modify the workflow by adding, removing, or connecting nodes as needed

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_workflow_modification.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=41c92ec069c65d4b523739a2cfd42c92" alt="Modify the workflow by adding, removing, or connecting nodes as needed" width="1918" height="870" data-path="images/glossary/comfyui_workflow_modification.png" />
    </Frame>
  </Step>

  <Step title="Save Workflow">
    Click **"Save"** in the actions bar and provide a descriptive commit message

    <Frame>
      <img src="https://mintcdn.com/flowscaleai/_NiiTj7mXdWDjGF6/images/glossary/comfyui_save_options.png?fit=max&auto=format&n=_NiiTj7mXdWDjGF6&q=85&s=901477bd9c2993025d52c9d7d827f39c" alt="Click Save in the actions bar and provide a descriptive commit message" width="1918" height="867" data-path="images/glossary/comfyui_save_options.png" />
    </Frame>
  </Step>
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Deploy to Production" icon="rocket" href="/getting-started/deploy-workflows">
    Transform workflows into production APIs and interactive interfaces
  </Card>
</CardGroup>
