Save 4 hours! We auto-setup your workflow! Free!

Drop your workflow.json — we handle every dependency, custom node, and model. Just open the link and run.

Auto-Setup Workflow Json (Free) Now!
ComfyUI > Nodes > OpenKatana > OpenKatana · All tools

ComfyUI Node: OpenKatana · All tools

Class Name

OpenKatanaTool

Category
OpenKatana/Studio
Author
rk0neki (Account age: 235days)
Extension
OpenKatana
Latest Updated
2026-11-05
Github Stars
0.05K

How to Install OpenKatana

Install this extension via the ComfyUI Manager by searching for OpenKatana
  • 1. Click the Manager button in the main menu
  • 2. Select Custom Nodes Manager button
  • 3. Enter OpenKatana in the search bar
After installation, click the Restart button to restart ComfyUI. Then, manually refresh your browser to clear the cache and access the updated list of nodes.

Visit ComfyUI Online for ready-to-use ComfyUI environment

  • Free trial available
  • 16GB VRAM to 80GB VRAM GPU machines
  • 400+ preloaded models/nodes
  • Freedom to upload custom models/nodes
  • 200+ ready-to-run workflows
  • 100% private workspace with up to 200GB storage
  • Dedicated Support

Run ComfyUI Online

OpenKatana · All tools Description

Run OpenKatana’s local video-production and project tools from ComfyUI using JSON commands.

OpenKatana · All tools:

OpenKatanaTool connects your ComfyUI workflow to OpenKatana’s local video-production tools, allowing you to run project operations without switching to a command-line interface or an agent connection. It provides a general-purpose way to access the available tool catalog through the same JSON-based command contract used by OpenKatana’s CLI and MCP integrations. This makes it useful when you want to combine AI-art workflows with local video-production tasks, including the analysis operations exposed by OpenKatana. Execution is local rather than paid or cloud-based. Model jobs return a job identifier instead of keeping the ComfyUI queue occupied until the model finishes. Because project state is shared with OpenKatana Studio, CLI, and MCP, this node is designed to execute again when evaluated rather than reuse a cached result that might no longer reflect your project.

OpenKatana · All tools Input Parameters:

tool

A required dropdown selection that chooses the OpenKatana operation to run. Its available options come directly from the installed OpenKatana TOOLS catalog, so the complete list depends on that installation and is not enumerated in the supplied source. The selected operation determines which information you must provide in arguments, what work is performed, and what result is returned. The supplied API context includes operations such as analyze_energy and analyze_clip, but you should use the actual dropdown and the selected tool’s contract to confirm availability and requirements. No explicit default selection or numeric minimum or maximum is declared.

project_id

A required text value identifying the OpenKatana project associated with the call, with a default of my-film. It is passed to the argument-preparation step alongside the selected tool and your JSON arguments, providing project context before execution. Use the identifier of the project you intend to work with, particularly when coordinating work between ComfyUI and OpenKatana Studio. A project identifier is not a media file path or a display title. The node declares no length limits, allowed-character restrictions, or numeric minimum or maximum; the supplied code also does not establish whether a particular tool creates a missing project or requires an existing one.

arguments

A required multiline text field containing the selected tool’s arguments as a JSON object, with a default of {}. This is where you specify tool-specific settings without adding separate controls to this general-purpose node. The selected operation determines which keys are required, which are optional, and which values are accepted. For example, the supplied analyze_clip signature requires clip_id and an operation chosen from masks, faces, interpolate, or retime, in addition to project context; it also accepts options and apply. The API rejects unsupported argument names and missing required arguments. Use valid JSON with double-quoted property names and lowercase boolean values such as false. No text-length limit or universal numeric range is declared for this field; individual tool settings have their own contracts, and the empty default is only sufficient when the selected operation needs no additional arguments after preparation.

after

An optional string connection used to establish an execution dependency on an upstream node. It is configured with forceInput, meaning you connect a compatible output rather than enter text in a normal widget. Connecting an earlier OpenKatana node’s string result can help ensure that its execution precedes this call, which is useful when several operations depend on shared project state. The implementation accepts after but does not read its content or forward it to the tool, so it does not supply arguments, interpret results, or check whether an asynchronous job has finished. No default value, length limit, or numeric minimum or maximum is declared.

OpenKatana · All tools Output Parameters:

result_json

A string containing the result returned through OpenKatana’s response wrapper. This is the node’s only declared output and is intended to carry the operation’s JSON result rather than a directly usable ComfyUI image, video, or mask tensor. Its contents depend on the tool you selected; the supplied code does not define a single universal response schema. For model jobs, the node description states that a job identifier is returned so ComfyUI can release its queue. Treat that identifier as a reference for checking the job, not as confirmation that processing has finished. If you need particular values for later workflow steps, inspect the returned structure and use a suitable JSON-processing node to extract them.

OpenKatana · All tools Usage Tips:

  • Check the selected tool’s signature before writing arguments. The API validates argument names strictly, so copying names exactly is more reliable than guessing equivalent wording.
  • Start with only the required tool settings, then add optional settings individually. The default {} is a starting point, not a complete configuration for every operation.
  • Use valid JSON rather than Python-style dictionaries: write double-quoted keys and strings, true or false for booleans, and null where a tool accepts an empty value.
  • Keep project_id consistent across nodes that work on the same project. If you also include a project identifier inside arguments, verify the argument-preparation behavior first; the supplied source does not show how conflicting identifiers are resolved.
  • Connect an upstream result_json to after when one project operation must execute before another. For asynchronous model work, check job completion separately, using the available OpenKatana job-status functionality; this connection alone does not wait for the model to finish.
  • For analyze_clip, choose an operation from masks, faces, interpolate, and retime. Its API signature defaults apply to false; review the tool’s documented application behavior before changing that setting.
  • For analyze_energy, the supplied signature offers start and duration to select a time interval, with start defaulting to 0 and duration defaulting to None. Use a relevant interval when you do not need the entire source analyzed; no numeric limits are provided in the context.
  • Remember that this node deliberately bypasses normal unchanged-result caching. Before repeatedly queuing a workflow, check whether the selected tool changes project state or starts a new job, because the call can run again even when its visible settings are unchanged.

OpenKatana · All tools Common Errors and Solutions:

Unknown OpenKatana tool

  • Explanation: The API raises this message when the requested tool is not present in its TOOLS catalog. A saved workflow may refer to a tool that is unavailable in the current installation.
  • Solution: Select an available operation from the current tool dropdown. If a previously available tool is missing, check that your OpenKatana installation and saved workflow use compatible versions.

TOOL_NAME: arguments must be a JSON object

  • Explanation: The API raises this message when the arguments reaching it are not a dictionary-like JSON object. TOOL_NAME represents the selected operation. A JSON list, number, or quoted string is not an object, even if it is otherwise valid JSON.
  • Solution: Enter an object containing named settings, such as {"clip_id": "your-clip-id", "operation": "faces"}, with the actual values required by your tool. Use {} only when no additional settings are required.

TOOL_NAME: unsupported arguments: ARGUMENT_NAMES (supported: PARAMETER_NAMES)

  • Explanation: One or more argument names do not match the selected tool’s signature. The actual message lists the unrecognized names and the supported parameter names, helping you identify spelling mistakes or settings copied from another tool.
  • Solution: Remove unsupported keys or replace them with the exact supported names listed in the error. Do not add extra descriptive fields unless the selected tool explicitly accepts them.

TOOL_NAME: missing required arguments: ARGUMENT_NAMES

  • Explanation: The prepared call does not include all parameters required by the selected tool. For example, analyze_clip requires a clip identifier and an operation as well as project context.
  • Solution: Add each listed missing parameter to arguments using the tool’s documented value format. Check that you selected the intended operation and that the project context is correct.

Invalid JSON in arguments — exact message not shown in the supplied source

  • Explanation: Malformed JSON can prevent the argument text from being prepared for the API call. Common causes include single quotes, trailing commas, missing quotation marks, and Python-style values such as True or None. The supplied code does not show the parser’s exact error message.
  • Solution: Validate the text as JSON, use double quotes around property names and string values, remove trailing commas, and use true, false, or null where appropriate.

A job identifier is returned, but the expected processing is not finished

  • Explanation: This is expected behavior for model jobs, not necessarily an error. The node releases ComfyUI’s queue after returning the job identifier, and the after connection does not check background-job completion.
  • Solution: Check the returned job identifier with OpenKatana’s job-status functionality before running work that requires the completed result. Distinguish successful job submission from successful job completion.

OpenKatana · All tools Related Nodes

Go back to the extension to check out more related nodes.
OpenKatana
RunComfy
Copyright 2025 RunComfy. All Rights Reserved.

RunComfy is the premier ComfyUI platform, offering ComfyUI online environment and services, along with ComfyUI workflows featuring stunning visuals. RunComfy also provides AI Models, enabling artists to harness the latest AI tools to create incredible art.

OpenKatana · All tools