Giter Club home page Giter Club logo

dream-textures's Introduction

Dream Textures, subtitle: Stable Diffusion built-in to Blender

Latest Release Join the Discord Total Downloads Buy on Blender Market

  • 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
  • Texture entire scenes with 'Project Dream Texture' and depth to image
  • 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.

If you want a visual guide to installation, see this video tutorial from Ashlee Martino-Tarr: https://youtu.be/kEcr8cNmqZk

Ensure you always install the latest version of the add-on if any guides become out of date.

Usage

Here's a few quick guides:

Setup instructions for various platforms and configurations.

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.

A graphic showing each step of the image generation process

Texture entire models and scenes with depth to image.

A graphic showing each step of the texture projection process

Inpaint to fix up images and convert existing textures into seamless ones automatically.

Outpaint to increase the size of an image by extending it in any direction.

A graphic showing each step of the outpainting process

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

A graphic showing each frame of a render pass, split with the original and generated result

Upscale your low-res generations 4x.

A graphic showing each step of the upscaling process

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

Compatibility

Dream Textures has been tested with CUDA and Apple Silicon GPUs. Over 4GB of VRAM is recommended.

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

Cloud Processing

If your hardware is unsupported, you can use DreamStudio to process in the cloud. Follow the instructions in the release notes to setup with DreamStudio.

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
  1. 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.
  2. After running the local add-on in Blender, setup the model weights like normal.
  3. 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

Tips

  1. On Apple Silicon, with the requirements-dream-studio.txt you may run into an error with gRPC using an incompatible binary. If so, please use the following command to install the correct gRPC version:
pip install --no-binary :all: grpcio --ignore-installed --target .python_dependencies --upgrade

dream-textures's People

Contributors

carson-katri avatar nullsensestudio avatar blastframe avatar gottfriedhofmann avatar gregnr avatar eltociear avatar timmyl17 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.