|
--- |
|
language: |
|
- en |
|
thumbnail: "https://huggingface.co/ProGamerGov/sdxl-360-diffusion/resolve/main/examples/gallery_grid.jpg" |
|
base_model: |
|
- stabilityai/stable-diffusion-xl-base-1.0 |
|
pipeline_tag: text-to-image |
|
tags: |
|
- '360' |
|
- '360°' |
|
- 360-degree |
|
- 360-image |
|
- equirectangular |
|
- equirectangular-projection |
|
- image-generation |
|
- text-to-image |
|
--- |
|
# SDXL 360 Diffusion |
|
|
|
 |
|
|
|
|
|
## General |
|
|
|
SDXL 360 Diffusion is a 3.5 billion parameter model designed to generate 360 degree spherical images from text descriptions. |
|
|
|
The model was trained from the [SD-XL 1.0-base model](https://huggingface.co/stabilityai/stable-diffusion-xl-base-1.0) on an extremely diverse dataset composed of tens of thousands of equirectangular images, depicting landscapes, interiors, humans, animals, and objects. All images were resized to 2048x1024 before training. |
|
|
|
Given the right prompt, the model should be capable of producing almost anything you want. |
|
|
|
|
|
## Usage |
|
|
|
The trigger phrase is "equirectangular 360 view", "360 panorama", or some variation of those words in your prompt. |
|
|
|
When rendering images, it's recommended that you choose a 2:1 aspect ratio, such as 1024x512, 1536x768, or 2048x1024. Afterwards, you can use an upscaler of your choosing to make the resolution high enough for sky-boxes, backgrounds, VR, VR therapy, and 3D worlds. |
|
|
|
|
|
## Additional Tools |
|
|
|
### HTML 360 Viewer |
|
|
|
To make the viewing and sharing of 360 images & video easier, I built a web browser based HTML 360 viewer that runs locally on your device. |
|
|
|
* You can try it out here on Github Pages: https://progamergov.github.io/html-360-viewer/ |
|
* Github code: https://github.com/ProGamerGov/html-360-viewer |
|
* You can append '`?url=`' followed by a link to your image in order to automatically load it into the 360 viewer, making sharing your 360 creations extremely easy. |
|
* Example: https://progamergov.github.io/html-360-viewer/?url=https://upload.wikimedia.org/wikipedia/commons/7/76/Dauderi.jpg |
|
|
|
|
|
### Recommended ComfyUI Nodes |
|
|
|
If you are a user of [ComfyUI](https://github.com/comfyanonymous/ComfyUI), then these sets of nodes can be useful for working with 360 images & videos. |
|
|
|
* ComfyUI_preview360panorama |
|
* For viewing 360s inside of ComfyUI (may be slower than my web browser viewer). |
|
* Link: https://github.com/ProGamerGov/ComfyUI_preview360panorama |
|
|
|
* ComfyUI_pytorch360convert |
|
* For editing 360s, applying circular Conv2d padding, and masking potential artifacts. |
|
* Link: https://github.com/ProGamerGov/ComfyUI_pytorch360convert |
|
|
|
For diffusers and other libraries, you can make use of the [pytorch360convert](https://github.com/ProGamerGov/pytorch360convert) library when working with 360 media. |
|
|
|
### LoRA Training |
|
|
|
Due to the relative scarcity of 360 images, it is often easier to produce your own 360s to teach the model new concepts. There are a number of ways that you can produce your own 360 images for training LoRAs: |
|
|
|
1. Blender Renders |
|
- There are tons of free models and scenes available, and you can pose characters exactly how you want. |
|
- Blender's [Cycles rendering engine with panoramic equirectangular setting](https://docs.blender.org/manual/en/latest/render/cycles/object_settings/cameras.html) generates 360 degree renders. |
|
2. Video Game Screenshots |
|
- Example: Using Nvidia Ansel. |
|
3. 360 Cameras |
|
- Public Libraries: 360 Cameras can sometimes be borrowed from libraries. |
|
- Purchasing: 360 Cameras can also be purchased. |
|
4. Digital illustration, Painting, & Drawing Tools |
|
- Some tools used for creating digital illustrations, drawings, paintings, and other mediums by hand also have the ability to help you create seamless 360 images. |
|
|
|
|
|
## Limitations |
|
|
|
Due to the nature of SDXL, multiple attempts may be required to achieve a desirable output based on a given prompt. |
|
|
|
|
|
## Contributors |
|
|
|
- [Ben Egan](https://github.com/ProGamerGov) |
|
- [XWAVE](https://twitter.com/XWAVEart) |
|
- [Jimmy Carter](https://huggingface.co/jimmycarter) |
|
|
|
|
|
## Citation Information |
|
|
|
BibTeX |
|
|
|
``` |
|
@software{Egan_SDXL_360_Diffusion_2025, |
|
author = {Egan, Ben and {XWAVE} and {Jimmy Carter}}, |
|
license = {MIT}, |
|
month = aug, |
|
title = {{SDXL 360 Diffusion}}, |
|
url = {https://huggingface.co/ProGamerGov/sdxl-360-diffusion}, |
|
year = {2025} |
|
} |
|
``` |
|
|
|
APA |
|
|
|
``` |
|
Egan, B., XWAVE, & Jimmy Carter. (2025). SDXL 360 Diffusion [Computer software]. https://huggingface.co/ProGamerGov/sdxl-360-diffusion |
|
``` |
|
|
|
Please refer to the [CITATION.cff](https://huggingface.co/ProGamerGov/sdxl-360-diffusion/blob/main/CITATION.cff) for more information on how to cite this dataset. |