LibreAI / Image / Kandinsky-2
// image · ai-forever/Kandinsky-2

Kandinsky-2

Kandinsky 2.2 — multilingual text-to-image latent diffusion with ControlNet, inpainting and image fusion

★ 2.8k stars⑂ 319 forksApache-2.0updated 2024-05
▦ visual — this project's README ships no embeddable screenshot,
so here's a placeholder. The guide below is complete regardless.
// project facts

Project facts

Kandinsky-2 is an open-source image project by ai-forever (ai-forever/Kandinsky-2 on GitHub). It has 2,810 GitHub stars and 319 forks, is released under the Apache-2.0 license, and was last updated on GitHub on 1 May 2024.

GitHub stars
2,810
Forks
319
License
Apache-2.0
Last updated on GitHub
1 May 2024
Category
Image
Listing
Full install guide
// how it works

How it works

  1. Clarify your goal

    Pick the task — text2image, img2img, inpainting or image fusion — and the model version (2.2 is the newest in the repo).

  2. Get Kandinsky

    Clone the repo or pip install it directly from GitHub as the README shows; model checkpoints download from Hugging Face.

  3. Install and configure

    Set up a CUDA environment (examples call get_kandinsky2('cuda', ...)) and open the example notebooks in ./notebooks.

  4. Run your first generation

    Call generate_text2img with a prompt — prompts can be multilingual — and inspect the output image.

// features

Why people love it

Multilingual prompts

Trained with multilingual text encoders (XLM-Roberta-based), so prompts work in many languages, not just English.

Kandinsky 2.2 encoder

2.2 switches to the CLIP-ViT-G image encoder for more aesthetic results and better text understanding.

ControlNet support

2.2 adds ControlNet (e.g. depth-conditioned decoding) for more controllable generation.

Inpainting and outpainting

Dedicated inpainting checkpoint and generate_inpainting API with masks.

Image fusion

mix_images blends multiple images and text prompts with per-input weights.

LoRA fine-tuning

A linked Colab notebook shows fine-tuning with LoRA, alongside an inference Colab.

Advertisement
// run it

Run it yourself

  1. Clone the repo

    Clone Kandinsky-2 and enter the directory.

    git clone https://github.com/ai-forever/Kandinsky-2.git
    cd Kandinsky-2
  2. Install the package

    Install directly from GitHub as the README shows.

    pip install "git+https://github.com/ai-forever/Kandinsky-2.git"
  3. Generate an image

    Use the README's text2image example with the 2.2 model on CUDA.

    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)
// use cases

What you can build

Advertisement
// faq

Questions, answered

Who maintains Kandinsky 2?

ai-forever (the team behind the Kandinsky models, originally from Sber AI research) maintains this repo; the authors are listed in the README.

Is it free?

The code is Apache-2.0 licensed; checkpoints are on Hugging Face. You need your own GPU hardware to run it.

Does it need a paid API key?

No — inference runs locally in PyTorch once checkpoints are downloaded.

How does it compare to Stable Diffusion?

Both are open latent-diffusion models. Kandinsky is distinguished by its multilingual text encoders, diffusion image prior design, and built-in image-fusion workflow.

How do I get started?

pip install it from GitHub, then run the text2image snippet or the linked Colab inference notebook.

// keep exploring

Similar tools

Image

omnigen-vault

Infinite text-free AI image generator with a searchable multilingual vault

★ 35 starsMIT
View guide →
Image

mmagic

MMagic — OpenMMLab's generative-AI toolbox: diffusion, text-to-image, restoration and a model zoo.

★ 7.5k starsApache-2.0
View guide →
Image

stable-diffusion-videos

Create 🔥 videos with Stable Diffusion by exploring the latent space and morphing between text prompts

★ 4.7k starsApache-2.0
View guide →
Image

Image-AI-Generator-2026

Desktop AI art studio — photoreal renders, ControlNet and upscaling

★ 53 starsMIT
View guide →
Image

lite.ai.toolkit

A lite C++ AI toolkit: 100+ models with MNN, ORT and TRT, including Det, Seg, Stable-Diffusion, Face-Fusion.

★ 4.4k starsGPL-3.0
View guide →
Image

react-image-editor

Drop-in React image editor — crop, filters, draw, text and AI assistant

★ 255 starsMIT
View guide →
// alternatives

Alternatives in Image

The most-starred other Image projects in the LibreAI catalogue — the realistic shortlist if Kandinsky-2 is not the right fit.

Get Kandinsky-2

Free and open — grab the source, star the repo, and start creating.