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 · Eye sheet

ComfyUI Node: OpenKatana · Eye sheet

Class Name

OpenKatana_eye_sheet

Category
OpenKatana/Tools
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 · Eye sheet Description

Creates eye-crop review sheets to visually inspect gaze direction and face-replacement artefacts.

OpenKatana · Eye sheet:

OpenKatana_eye_sheet creates visual review sheets of eye crops so you can inspect gaze direction and spot eye-related artefacts, particularly white or doubled eyes introduced by face replacement. By arranging cropped eye regions together, it makes it easier to compare eye appearance across frames without repeatedly examining full-sized images. The review process is visual: you judge whether the eyes look natural and whether their direction is appropriate. The tool does not calculate an automatic gaze score, diagnose defects, or repair the eyes. Its purpose is to support quality control by making potentially problematic eye details easier to examine.

OpenKatana · Eye sheet Input Parameters:

project_id

A required STRING that identifies the OpenKatana project associated with the operation. The node passes this value into its argument-preparation process before calling the eye-sheet tool, so you should use the identifier for the project containing the material you want to review. The supplied code does not show how project identifiers are validated or how a project is selected internally. No default value, allowed-value list, length limit, or minimum or maximum value is provided in the supplied interface.

arguments

A required STRING containing the tool arguments that are processed before the eye-sheet operation is called. This is the interface’s place for supplying operation-specific settings rather than adding separate node inputs. The underlying function shown in the context accepts project-root, clip, output-location, and frame-selection information, but the supplied excerpts do not establish the exact public argument keys, their required formats, or which values OpenKatana supplies automatically. Use the argument schema or a working example from your installed OpenKatana version rather than treating the internal function signature as a complete JSON template. No default string, supported options, numerical limits, or frame-selection syntax is exposed in the provided node interface.

after

An optional STRING accepted by the node’s execution method. In the supplied implementation, this value is not explicitly read, added to the tool arguments, or passed into the tool invocation, so there is no demonstrated effect on the generated eye sheets. Any broader workflow-ordering behavior would need to be confirmed from the surrounding OpenKatana implementation; the provided code alone does not establish it. You can omit this input when it is not required by your workflow. The execution method defaults to None when it is omitted, and no string default, allowed options, or minimum or maximum values are shown.

OpenKatana · Eye sheet Output Parameters:

result_json

A STRING containing the response produced by the tool call and its response-formatting layer. The underlying eye-sheet function returns preview_images, which contains the paths to the generated review-sheet images; frames, which contains the frame-related records collected during processing; and note, which explains that the crops are intended for visual evaluation of gaze and eye artefacts and that no automatic gaze score is computed. The function also writes those records to an eyes.json file in its output directory and generates sheets with up to 60 tiles per sheet. The supplied context does not show the full response wrapper or the fields inside each frame record, so do not assume a more detailed response structure. This output is text, not a directly connectable ComfyUI IMAGE output; inspect the response and open the referenced preview files to review the results.

OpenKatana · Eye sheet Usage Tips:

  • Review the sheets after face replacement, paying particular attention to white eyes, doubled eye features, and gaze that appears inconsistent with the shot. The node helps you inspect these issues but does not correct them.
  • Use a supported frame-selection argument to focus on suspicious moments if your installed tool schema offers that control. The underlying function accepts a frame-selection value, but its public argument name and selection syntax are not established in the supplied context.
  • For longer reviews, check every generated preview path rather than only the first image. The sheet-generation call uses a limit of 60 tiles per sheet, so a larger collection of crops can produce multiple sheets.
  • Inspect the original frames around any suspicious crop before making an editing decision. A crop is useful for checking eye detail, but the full frame provides context for head position, expression, and intended gaze.
  • Keep the generated eyes.json file with the preview sheets when documenting a review. It stores the records returned as frames, although the supplied code does not specify the individual record fields.
  • Use the argument format documented for your installed OpenKatana version, and keep operation settings inside arguments rather than inventing additional node sockets. The wrapper explicitly rejects unexpected extra inputs.

OpenKatana · Eye sheet Common Errors and Solutions:

unexpected inputs: ...

  • Explanation: This is an explicit error pattern in the supplied node code. The execution wrapper raises a TypeError when extra keyword inputs are not included in the tool’s declared typed inputs. The authoritative interface for this node lists only project_id, arguments, and optional after.
  • Solution: Remove additional inputs supplied by a custom workflow or API call. Put supported operation settings in arguments using the installed tool’s documented argument format rather than passing them as additional node inputs.

Argument parsing or validation failure — exact message not shown

  • Explanation: The node processes arguments before invoking the tool, but the parsing implementation and its error messages are not included. An incorrectly formatted argument string or unsupported argument structure may therefore fail before any sheets are generated.
  • Solution: Compare your argument string with the schema or a working example for the installed eye-sheet tool. If that format is JSON, check quotation marks, commas, and brackets. Do not assume that the internal function’s parameter names constitute the complete public argument schema.

Project or clip cannot be resolved — exact message not shown

  • Explanation: Creating eye crops requires access to the intended project and clip. An incorrect identifier or a reference to unavailable material can prevent processing, although the supplied excerpts do not show the validation logic or an exact error message.
  • Solution: Confirm that project_id matches the intended project and that any clip reference in your supported arguments belongs to accessible project material. Verify the selection through your existing OpenKatana workflow before retrying.

Preview images or eyes.json cannot be written — exact message not shown

  • Explanation: The tool generates image files and writes eyes.json to its output directory. An inaccessible destination, insufficient write permissions, or a full disk can prevent these files from being saved. These are possible file-writing failures, not error strings confirmed by the supplied code.
  • Solution: Check that the configured output location is available, writable by the process running ComfyUI, and has enough free space. If your installed tool allows output-location configuration, use an approved writable directory.

No automatic gaze score or direct IMAGE output

  • Explanation: This is expected behavior, not a processing error. The tool explicitly states that no automatic gaze score is computed, and the node exposes only the STRING output result_json.
  • Solution: Inspect the returned response for preview_images and open the referenced sheets for visual review. If you need to bring a sheet into another image-processing workflow, load the saved image separately rather than connecting result_json directly to an IMAGE input.

OpenKatana · Eye sheet 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 · Eye sheet