ComfyUI-Kitsu

Kitsu integration for ComfyUI: publish AI versions and pull shot context for render naming.

Install

1. Copy this folder into ComfyUI/custom_nodes/ComfyUI-Kitsu
2. Install dependencies into the ComfyUI Python environment:

pip install -r requirements.txt

3. Create credentials file (never commit this). Copy one JSON block from .login.example into .login (API Token or Username/Password), then fill in real values. Do not leave example comments in .login.

4. Restart ComfyUI

Credentials are read only on the ComfyUI server from .login. They are not stored on nodes or in saved workflows. server_url stays on each node.

---

Node: Kitsu Shot Context

Category: Kitsu · ID: KitsuShotContext

Cascading dropdowns: Project → Episode → Sequence → Shot → Task. Outputs STRING sockets for automatic naming / metadata.

Output	Source
client	project.data.client / client_name, else project name
episode	Episode name (empty for non-episodic shows)
sequence	Sequence name
shot	Shot name
description	Shot description
frame_range	data.frame_in-data.frame_out (or nb_frames fallback)
camera	shot.data: camera, cam, camera_name
lens	shot.data: lens, lens_mm, focal_length
notes	shot.data: notes, note, production_notes
reference_urls	shot.data: reference_urls, references, ref_urls
delivery_resolution	Shot/project resolution fields
filename_stem	{episode_}{sequence}_{shot} (episode omitted when empty)
fps	Project fps
nb_frames	Shot frame count
task	Selected task type name
latest_version	Highest preview revision on the selected task (0 if none)

Wire filename_stem / latest_version into Save Image / filename prefixes.

---

Node: Publish AI Version

Category: Kitsu · ID: PublishAIVersion

Packages the live ComfyUI workflow and optional media, then publishes to a Kitsu task as a preview revision with the workflow attached to the comment.

Connection

Field	Notes
server_url	API root, e.g. http://kitsu.server:8012/api
Auth	From .login (see above)

Cascading dropdowns: project → sequence → shot → task.

Package contents

{Shot}_v{NNN}/
├── {Sequence}_{Shot}_v{NNN}.json   # Kitsu revision; no credentials
├── preview.png
├── render.png
├── thumbnail.png
├── mask.png
└── alpha.png

Outputs

success, version_id (revision int), version_url, publish_time (seconds), status

---

License

MIT — Julien Brami