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
- Verify the file workflows/<workflow_key> exists relative to the app's working directory (ls workflows/)
- Download or restore the missing workflow JSON into the workflows directory
- Fix the workflow_key value in the pipeline settings to match an existing file name
- 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
- Verify all workflow_key values against os.listdir('workflows') on app startup
- Launch the app consistently from the repo root or make paths absolute
- Keep workflow JSONs in version control so they are never missing after clone
- Fail fast with a startup check instead of mid-render
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
- The second step workflow file does not exist:{second_workflo
- No default workflow configured for {self.service_name}. Plea
- Resource not found: {os.path.join(resource_type, *paths)}
- Template not found: {size}/{template_name} Available templat
- Template not found: {size}/{template_name} Available sizes:
AI-assisted analysis of ATH-MaaS/Pixelle-Video@848b054e4f (2026-08-30).
Data as JSON: /api/errors/595e8a5e53513128.
Report an issue: GitHub.