gitwtfhub

wtf is comfyui-spherope?

cedarconnor/comfyui-spherope — explained in plain English

Analysis updated 2026-05-18

10PythonAudience · vibe coderComplexity · 4/5Setup · hard

TL;DR

ComfyUI custom nodes that fix seams and pole distortion when generating seamless 360 degree images or video with LTX and FLUX.2.

Mindmap

mindmap
  root((ComfyUI-SpheRoPE))
    What it does
      Fixes 360 seam tearing
      Reduces pole distortion
      Patches LTX and FLUX.2
    Tech stack
      Python
      ComfyUI
      PyTorch
    Use cases
      Generate seamless 360 video
      Generate seamless VR panoramas
      Diagnose seam and pole quality
    Audience
      AI image and video generation users
      ComfyUI workflow builders
    Nodes
      Spherical RoPE patch
      ERP Guider
      Circular VAE Decode
      Wrapped Noise

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Generate a seamless 360 degree panoramic video with LTX for VR use.

REASON 2

Generate a seamless equirectangular still image with FLUX.2.

REASON 3

Diagnose and measure seam or pole distortion in existing 360 generations.

What's in the stack?

PythonComfyUIPyTorch

How it stacks up

cedarconnor/comfyui-spheropeaarav90-cpu/fetchitadammartinez271828/x4-analysis
Stars101010
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity4/52/52/5
Audiencevibe coderdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · hard Time to first run · 1h+

Requires separately downloading large LTX-2.3 or FLUX.2 model checkpoints and their text encoders.

Wtf does this do

ComfyUI-SpheRoPE is a set of custom nodes for ComfyUI, a visual workflow tool for running AI image and video generation models. It solves a specific visual problem: when an AI model generates a 360 degree panoramic image or video meant to wrap fully around a viewer, like the kind used in VR, the model does not know the frame is supposed to loop seamlessly. This causes a visible seam where the left and right edges do not line up, and warping or smearing near the top and bottom poles of the sphere. SpheRoPE fixes this problem at generation time, without needing a specially retrained model, by patching how two existing models, LTX for video and FLUX.2 for images, handle position information internally so that the far edges of the image are treated as neighbors instead of opposite ends. The fix works through four coordinated pieces, each its own ComfyUI node: adjusting the model's internal position encoding so edge pixels connect properly, an optional guidance mechanism that nudges the output toward geometrically consistent spherical shapes, a wrap-aware decoding step that keeps the seam continuous when converting the model's internal representation into a final image or video, and an optional adjustment to the random starting noise that reduces distortion at the poles. The project includes 14 nodes total, covering the core fixes as well as diagnostic nodes that measure how well the seam and poles turned out. Both backends have been tested on real, named model checkpoints, and the documentation reports large measurable reductions in the pole distortion problem for the image backend. Installing it means cloning the repository into ComfyUI's custom nodes folder and restarting ComfyUI, along with separately downloading the specific LTX or FLUX.2 model files it depends on. The project includes runnable example scripts and 124 automated tests to verify its behavior. It describes itself as an independent reimplementation of a research method called SpheRoPE, built natively for ComfyUI rather than wrapping the original research code, which is licensed for noncommercial use only.

Yoink these prompts

Prompt 1
Walk me through installing ComfyUI-SpheRoPE and its LTX or FLUX.2 model dependencies.
Prompt 2
Explain what the Spherical RoPE patch does differently from a normal LTX or FLUX.2 workflow.
Prompt 3
Help me build a FLUX.2 text-to-panorama workflow using the ERP Guider and Circular VAE Decode nodes.
Prompt 4
Why does the README warn against setting cfg to 1 on the ERP Guider?

Frequently asked questions

wtf is comfyui-spherope?

ComfyUI custom nodes that fix seams and pole distortion when generating seamless 360 degree images or video with LTX and FLUX.2.

What language is comfyui-spherope written in?

Mainly Python. The stack also includes Python, ComfyUI, PyTorch.

How hard is comfyui-spherope to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is comfyui-spherope for?

Mainly vibe coder.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.