cedarconnor/comfyui-spherope — explained in plain English
Analysis updated 2026-05-18
Generate a seamless 360 degree panoramic video with LTX for VR use.
Generate a seamless equirectangular still image with FLUX.2.
Diagnose and measure seam or pole distortion in existing 360 generations.
| cedarconnor/comfyui-spherope | aarav90-cpu/fetchit | adammartinez271828/x4-analysis | |
|---|---|---|---|
| Stars | 10 | 10 | 10 |
| Language | Python | Python | Python |
| Setup difficulty | hard | easy | easy |
| Complexity | 4/5 | 2/5 | 2/5 |
| Audience | vibe coder | developer | general |
Figures from each repo's GitHub metadata at analysis time.
Requires separately downloading large LTX-2.3 or FLUX.2 model checkpoints and their text encoders.
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.
ComfyUI custom nodes that fix seams and pole distortion when generating seamless 360 degree images or video with LTX and FLUX.2.
Mainly Python. The stack also includes Python, ComfyUI, PyTorch.
Setup difficulty is rated hard, with roughly 1h+ to a first successful run.
Mainly vibe coder.
This repo across BitVibe Labs
Don't trust strangers blindly. Verify against the repo.