This repository is archived and no longer maintained. The code has been integrated directly into the ComfyUI Frontend repository.

As of August 5, 2025, Comfy-Org/litegraph.js is now part of the ComfyUI Frontend monorepo:

• Source Code: https://github.com/Comfy-Org/ComfyUI_frontend/tree/main/src/lib/litegraph
• Repository: https://github.com/Comfy-Org/ComfyUI_frontend
• Pull Request: Comfy-Org/ComfyUI_frontend#4667
• Architecture Decision: https://github.com/Comfy-Org/ComfyUI_frontend/blob/main/docs/adr/0001-merge-litegraph-into-frontend.md

• Report Issues: Please report any issues at https://github.com/Comfy-Org/ComfyUI_frontend/issues
• Contribute: All contributions should be made to the ComfyUI Frontend repository
• Import Path: Changed from @comfyorg/litegraph to @/lib/litegraph within ComfyUI

The complete git history has been preserved using git subtree merge. All commits, authors, and timestamps remain intact in the new location.

Comfy-Org/litegraph.js was only used by ComfyUI, and maintaining it as a separate package created unnecessary complexity. The integration enables:

• Faster development cycles
• Better architectural refactoring
• Simplified maintenance
• No more version mismatch issues

For more details, see the Architecture Decision Record.

This is the litegraph version used in ComfyUI_frontend.

It is a fork of the original litegraph.js. Some APIs may by unchanged, however it is largely incompatible with the original.

Some early highlights:

• Accumulated comfyUI custom changes (2024-01 ~ 2024-05) (#1)
• Type schema change for ComfyUI_frontend TS migration (#3)
• Zoom fix (#7)
• Emit search box triggering custom events (#10)
• Truncate overflowing combo widget text (#17)
• Sort node based on ID on graph serialization (#21)
• Fix empty input not used when connecting links (#24)
• Batch output connection move/disconnect (#39)
• And now with hundreds more...

npm i @comfyorg/litegraph

A TypeScript library to create graphs in the browser similar to Unreal Blueprints.

• Renders on Canvas2D (zoom in/out and panning, easy to render complex interfaces, can be used inside a WebGLTexture)
• Easy to use editor (searchbox, keyboard shortcuts, multiple selection, context menu, ...)
• Optimized to support hundreds of nodes per graph (on editor but also on execution)
• Customizable theme (colors, shapes, background)
• Callbacks to personalize every action/drawing/event of nodes
• Graphs can be executed in NodeJS
• Highly customizable nodes (color, shape, widgets, custom rendering)
• Easy to integrate in any JS application (one single file, no dependencies)
• Typescript support

You can install it using npm

npm install @comfyorg/litegraph

Here is an example of how to build a node that sums two inputs:

import { LiteGraph, LGraphNode } from "./litegraph"

class MyAddNode extends LGraphNode {
  // Name to show
  title = "Sum"

  constructor() {
    this.addInput("A", "number")
    this.addInput("B", "number")
    this.addOutput("A+B", "number")
    this.properties.precision = 1
  }

  // Function to call when the node is executed
  onExecute() {
    var A = this.getInputData(0)
    if (A === undefined) A = 0
    var B = this.getInputData(1)
    if (B === undefined) B = 0
    this.setOutputData(0, A + B)
  }
}

// Register the node type
LiteGraph.registerNodeType("basic/sum", MyAddNode)

It also works server-side using NodeJS although some nodes do not work in server (audio, graphics, input, etc).

import { LiteGraph, LGraph } from "./litegraph.js"

const graph = new LGraph()

const firstNode = LiteGraph.createNode("basic/sum")
graph.add(firstNode)

const secondNode = LiteGraph.createNode("basic/sum")
graph.add(secondNode)

firstNode.connect(0, secondNode, 1)

graph.start()

Please open an issue on the GitHub repo.

Litegraph has no runtime dependencies. The build tooling has been tested on Node.JS 20.18.x

Use GitHub actions to release normal versions.

1. Run the Release a New Version action, selecting the version incrment type
2. Merge the resultion PR
3. A GitHub release is automatically published on merge

The action directly translates Version increment type to the npm version command. Pre-release ID (suffix) is the option for the --preid argument.

e.g. Use prerelease increment type to automatically bump the patch version and create a pre-release version. Subsequent runs of prerelease will update the prerelease version only. Use patch when ready to remove the pre-release suffix.

You can find the current list of contributors on GitHub.

• atlasan
• kriffe
• rappestad
• InventivetalentDev
• NateScarlet
• coderofsalvation
• ilyabesk
• gausszhou