Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ai-forever/Kandinsky-2

Kandinsky 2 — multilingual text2image latent diffusion model
https://github.com/ai-forever/Kandinsky-2

diffusion image-generation image2image inpainting ipython-notebook kandinsky outpainting text-to-image text2image

Last synced: 7 days ago
JSON representation

Kandinsky 2 — multilingual text2image latent diffusion model

Host: GitHub
URL: https://github.com/ai-forever/Kandinsky-2
Owner: ai-forever
License: apache-2.0
Created: 2022-10-14T18:13:08.000Z (about 2 years ago)
Default Branch: main
Last Pushed: 2024-05-01T17:03:31.000Z (7 months ago)
Last Synced: 2024-10-29T14:52:52.405Z (14 days ago)
Topics: diffusion, image-generation, image2image, inpainting, ipython-notebook, kandinsky, outpainting, text-to-image, text2image
Language: Jupyter Notebook
Homepage:
Size: 37.3 MB
Stars: 2,759
Watchers: 49
Forks: 308
Open Issues: 82
Metadata Files:
- Readme: README.md
- License: license

Awesome Lists containing this project

README

        # Kandinsky 2.2

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1MfN9dfmejT8NjXhR353NeP5RzbruHgo7?usp=sharing) — Inference example

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1lUWfe4CWhPJhUZYjMAE7g4ciHX4764rN?usp=sharing) — Fine-tuning with LoRA

+ [Habr post](https://habr.com/ru/companies/sberbank/articles/747446/)

+ [Demo fusionbrain.ai](https://fusionbrain.ai/diffusion)

+ [Telegram-bot](https://t.me/kandinsky21_bot)







**Description:**

Kandinsky 2.2 brings substantial improvements upon its predecessor, Kandinsky 2.1, by introducing a new, more powerful image encoder - CLIP-ViT-G and the ControlNet support.

The switch to CLIP-ViT-G as the image encoder significantly increases the model's capability to generate more aesthetic pictures and better understand text, thus enhancing the model's overall performance.

The addition of the ControlNet mechanism allows the model to effectively control the process of generating images. This leads to more accurate and visually appealing outputs and opens new possibilities for text-guided image manipulation.

**Architecture details:**

+ Text encoder (XLM-Roberta-Large-Vit-L-14) - 560M

+ Diffusion Image Prior — 1B

+ CLIP image encoder (ViT-bigG-14-laion2B-39B-b160k) - 1.8B

+ Latent Diffusion U-Net - 1.22B

+ MoVQ encoder/decoder - 67M

**Сheckpoints:**

+ [Prior](https://huggingface.co/kandinsky-community/kandinsky-2-2-prior): A prior diffusion model mapping text embeddings to image embeddings

+ [Text-to-Image / Image-to-Image](https://huggingface.co/kandinsky-community/kandinsky-2-2-decoder): A decoding diffusion model mapping image embeddings to images

+ [Inpainting](https://huggingface.co/kandinsky-community/kandinsky-2-2-decoder-inpaint): A decoding diffusion model mapping image embeddings and masked images to images

+ [ControlNet-depth](https://huggingface.co/kandinsky-community/kandinsky-2-2-controlnet-depth): A decoding diffusion model mapping image embedding and additional depth condition to images

### Inference regimes







## How to use:

Check our jupyter notebooks with examples in `./notebooks` folder

### 1. text2image

```python

from kandinsky2 import get_kandinsky2

model = get_kandinsky2('cuda', task_type='text2img', model_version='2.2')

images = model.generate_text2img(

    "red cat, 4k photo", 

    decoder_steps=50,

    batch_size=1, 

    h=1024,

    w=768,

)

```

# Kandinsky 2.1

[![Framework: PyTorch](https://img.shields.io/badge/Framework-PyTorch-orange.svg)](https://pytorch.org/) [![Huggingface space](https://img.shields.io/badge/🤗-Huggingface-yello.svg)](https://huggingface.co/sberbank-ai/Kandinsky_2.1)

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1xSbu-b-EwYd6GdaFPRVgvXBX_mciZ41e?usp=sharing)

[Habr post](https://habr.com/ru/company/sberbank/blog/725282/)

[Demo](https://fusionbrain.ai/diffusion)

`pip install "git+https://github.com/ai-forever/Kandinsky-2.git"`

## Model architecture:







Kandinsky 2.1 inherits best practicies from Dall-E 2 and Latent diffusion, while introducing some new ideas.

As text and image encoder it uses CLIP model and diffusion image prior (mapping) between latent spaces of CLIP modalities. This approach increases the visual performance of the model and unveils new horizons in blending images and text-guided image manipulation.

For diffusion mapping of latent spaces we use transformer with num_layers=20, num_heads=32 and hidden_size=2048.

**Other architecture parts:**

+ Text encoder (XLM-Roberta-Large-Vit-L-14) - 560M

+ Diffusion Image Prior — 1B

+ CLIP image encoder (ViT-L/14) - 427M

+ Latent Diffusion U-Net - 1.22B

+ MoVQ encoder/decoder - 67M

Kandinsky 2.1 was trained on a large-scale image-text dataset LAION HighRes and fine-tuned on our internal datasets.

## How to use:

 Check our jupyter notebooks with examples in `./notebooks` folder

### 1. text2image

```python

from kandinsky2 import get_kandinsky2

model = get_kandinsky2('cuda', task_type='text2img', model_version='2.1', use_flash_attention=False)

images = model.generate_text2img(

    "red cat, 4k photo", 

    num_steps=100,

    batch_size=1, 

    guidance_scale=4,

    h=768, w=768,

    sampler='p_sampler', 

    prior_cf_scale=4,

    prior_steps="5"

)

```

![](./content/einstein.png)

prompt: "Einstein in space around the logarithm scheme"

### 2. image fuse

```python

from kandinsky2 import get_kandinsky2

from PIL import Image

model = get_kandinsky2('cuda', task_type='text2img', model_version='2.1', use_flash_attention=False)

images_texts = ['red cat', Image.open('img1.jpg'), Image.open('img2.jpg'), 'a man']

weights = [0.25, 0.25, 0.25, 0.25]

images = model.mix_images(

    images_texts, 

    weights, 

    num_steps=150,

    batch_size=1, 

    guidance_scale=5,

    h=768, w=768,

    sampler='p_sampler', 

    prior_cf_scale=4,

    prior_steps="5"

)

```

![](./content/fuse.png)

### 3. inpainting

```python

from kandinsky2 import get_kandinsky2

from PIL import Image

import numpy as np

model = get_kandinsky2('cuda', task_type='inpainting', model_version='2.1', use_flash_attention=False)

init_image = Image.open('img.jpg')

mask = np.ones((768, 768), dtype=np.float32)

mask[:,:550] =  0

images = model.generate_inpainting(

    'man 4k photo', 

    init_image, 

    mask, 

    num_steps=150,

    batch_size=1, 

    guidance_scale=5,

    h=768, w=768,

    sampler='p_sampler', 

    prior_cf_scale=4,

    prior_steps="5"

)

```

# Kandinsky 2.0

[![Framework: PyTorch](https://img.shields.io/badge/Framework-PyTorch-orange.svg)](https://pytorch.org/) [![Huggingface space](https://img.shields.io/badge/🤗-Huggingface-yello.svg)](https://huggingface.co/sberbank-ai/Kandinsky_2.0) 

[![Open In Colab](https://colab.research.google.com/assets/colab-badge.svg)](https://colab.research.google.com/drive/1uPg9KwGZ2hJBl9taGA_3kyKGw12Rh3ij?usp=sharing)

[Habr post](https://habr.com/ru/company/sberbank/blog/701162/)

[Demo](https://fusionbrain.ai/diffusion)

`pip install "git+https://github.com/ai-forever/Kandinsky-2.git"`

## Model architecture:

It is a latent diffusion model with two multilingual text encoders:

* mCLIP-XLMR 560M parameters

* mT5-encoder-small 146M parameters

These encoders and multilingual training datasets unveil the real multilingual text-to-image generation experience!

**Kandinsky 2.0** was trained on a large 1B multilingual set, including samples that we used to train Kandinsky.

In terms of diffusion architecture Kandinsky 2.0 implements UNet with 1.2B parameters.

**Kandinsky 2.0** architecture overview:

![](./content/NatallE.png)

## How to use:

 

 Check our jupyter notebooks with examples in `./notebooks` folder

 

### 1. text2img

```python

from kandinsky2 import get_kandinsky2

model = get_kandinsky2('cuda', task_type='text2img')

images = model.generate_text2img('A teddy bear на красной площади', batch_size=4, h=512, w=512, num_steps=75, denoised_type='dynamic_threshold', dynamic_threshold_v=99.5, sampler='ddim_sampler', ddim_eta=0.05, guidance_scale=10)

```

![](./content/bear.jpeg)

prompt: "A teddy bear на красной площади"

### 2. inpainting

```python 

from kandinsky2 import get_kandinsky2

from PIL import Image

import numpy as np

model = get_kandinsky2('cuda', task_type='inpainting')

init_image = Image.open('image.jpg')

mask = np.ones((512, 512), dtype=np.float32)

mask[100:] =  0

images = model.generate_inpainting('Девушка в красном платье', init_image, mask, num_steps=50, denoised_type='dynamic_threshold', dynamic_threshold_v=99.5, sampler='ddim_sampler', ddim_eta=0.05, guidance_scale=10)

```

![](./content/inpainting.png)

prompt: "Девушка в красном платье"

### 3. img2img

```python

from kandinsky2 import get_kandinsky2

from PIL import Image

model = get_kandinsky2('cuda', task_type='img2img')

init_image = Image.open('image.jpg')

images = model.generate_img2img('кошка', init_image, strength=0.8, num_steps=50, denoised_type='dynamic_threshold', dynamic_threshold_v=99.5, sampler='ddim_sampler', ddim_eta=0.05, guidance_scale=10)

```

# Authors

+ Arseniy Shakhmatov: [Github](https://github.com/cene555), [Blog](https://t.me/gradientdip)

+ Anton Razzhigaev: [Github](https://github.com/razzant), [Blog](https://t.me/abstractDL)

+ Aleksandr Nikolich: [Github](https://github.com/AlexWortega), [Blog](https://t.me/lovedeathtransformers)

+ Vladimir Arkhipkin: [Github](https://github.com/oriBetelgeuse)

+ Igor Pavlov: [Github](https://github.com/boomb0om)

+ Andrey Kuznetsov: [Github](https://github.com/kuznetsoffandrey)

+ Denis Dimitrov: [Github](https://github.com/denndimitrov)