ATH-MaaS/Pixelle-Video · error · Exception

The workflow file does not exist: {workflow_path}

Error message

The workflow file does not exist: {workflow_path}

What it means

generate_audio_visual_video in web/pipelines/action_transfer.py resolves the ComfyUI workflow as Path('workflows') / workflow_key and raises a plain Exception if that file does not exist on disk before loading its JSON config.

Source

Thrown at web/pipelines/action_transfer.py:407

                                title="动作迁移" if get_language() == "zh_CN" else "Action Transfer",
                                input_params={
                                    "text": prompt,
                                    "prompt_text": prompt,
                                    "image_assets": image_assets,
                                    "video_assets": video_assets,
                                    "duration": second,
                                    "workflow_key": workflow_key,
                                    "api_video_params": api_video_params,
                                },
                            )
                            return media_result.url

                        kit = await pixelle_video._get_or_create_comfykit()

                        workflow_path = Path("workflows") / workflow_key

                        if not workflow_path.exists():
                            raise Exception(f"The workflow file does not exist: {workflow_path}")

                        with open(workflow_path, 'r', encoding='utf-8') as f:
                            workflow_config = json.load(f)

                        workflow_params = {
                            "video": video_path,
                            "image": image_path,
                            "prompt": prompt,
                            "second": second
                        }

                        if workflow_config.get("source") == "runninghub" and "workflow_id" in workflow_config:
                            workflow_input = workflow_config["workflow_id"]
                        else:
                            workflow_input = str(workflow_path)

                        video_result = await kit.execute(workflow_input, workflow_params)

View on GitHub (pinned to 848b054e4f)

Solutions

  1. Verify the file workflows/<workflow_key> exists relative to the app's working directory (ls workflows/)
  2. Download or restore the missing workflow JSON into the workflows directory
  3. Fix the workflow_key value in the pipeline settings to match an existing file name
  4. Launch the app from the repository root so the relative 'workflows' path resolves

Example fix

// before
workflow_key = "audio_visual_custom.json"  # file doesn't exist
// after
workflow_key = "action_transfer.json"  # exists under workflows/
Defensive patterns

Strategy: validation

Validate before calling

from pathlib import Path
workflow_path = Path("workflows") / workflow_key
if not workflow_path.is_file():
    raise FileNotFoundError(f"Workflow missing: {workflow_path.resolve()}")

Try / catch

try:
    video_url = await generate_audio_visual_video(...)
except Exception as e:
    if "workflow file does not exist" in str(e):
        st.error(f"Workflow '{workflow_key}' not found under workflows/; restore it or pick another.")

Prevention

When it happens

Trigger: _render_output_preview renders the action-transfer pipeline with a workflow_key whose file is missing under the 'workflows' directory relative to the current working directory — e.g. a renamed, deleted, or never-downloaded workflow JSON, or the app was launched from a different working directory.

Common situations: Fresh checkout without the workflows folder populated; user configured a custom workflow key that doesn't match a file name; running the web app from a directory other than the repo root so the relative 'workflows' path doesn't resolve.

Related errors


AI-assisted analysis of ATH-MaaS/Pixelle-Video@848b054e4f (2026-08-30). Data as JSON: /api/errors/595e8a5e53513128. Report an issue: GitHub.