3dhead / dream-textures

Stable Diffusion built-in to the Blender shader editor

• Create textures, concept art, background assets, and more with a simple text prompt
• Use the 'Seamless' option to create textures that tile perfectly with no visible seam
• Quickly create variations on an existing texture
• Re-style animations with the Cycles render pass
• Run the models on your machine to iterate without slowdowns from a service

Installation

Download the latest release and follow the instructions there to get up and running.

On macOS, it is possible you will run into a quarantine issue with the dependencies. To work around this, run the following command in the app Terminal: xattr -r -d com.apple.quarantine ~/Library/Application\ Support/Blender/3.3/scripts/addons/dream_textures/.python_dependencies. This will allow the PyTorch .dylibs and .sos to load without having to manually allow each one in System Preferences.

Usage

Here's a few quick guides:

Image Generation

Create textures, concept art, and more with text prompts. Learn how to use the various configuration options to get exactly what you're looking for.

Inpainting

Fix up images and convert existing textures into seamless ones automatically.

Render Pass

Perform style transfer and create novel animations with Stable Diffusion as a post processing step.

AI Upscaling

Convert your low-res generations to 2K, 4K, and higher with Real-ESRGAN built-in.

History

Recall, export, and import history entries for later use.

Compatibility

Dream Textures has been tested with CUDA and Apple Silicon GPUs.

If you have an issue with a supported GPU, please create an issue.

Contributing

After cloning the repository, there a few more steps you need to complete to setup your development environment:

1. Install submodules:

git submodule update --init --recursive

2. I recommend the Blender Development extension for VS Code for debugging. If you just want to install manually though, you can put the dream_textures repo folder in Blender's addon directory.
3. After running the local add-on in Blender, setup the model weights like normal.
4. Install dependencies locally
   • Open Blender's preferences window
   • Enable Interface > Display > Developer Extras
   • Then install dependencies for development under Add-ons > Dream Textures > Development Tools
   • This will download all pip dependencies for the selected platform into .python_dependencies