Kandinsky-5.0-T2I-Lite

<div align="center"> <picture> <source media="(prefers-color-scheme: dark)" srcset="https://github.com/kandinskylab/kandinsky-5/raw/main/assets/KANDINSKY_LOGO_1_WHITE.png"> <source media="(prefers-color-scheme: light)" srcset="https://github.com/kandinskylab/kandinsky-5/raw/main/assets/KANDINSKY_LOGO_1_BLACK.png"> <img alt="Kandinsky Logo" src="https://user-images.githubusercontent.com/25423296/163456779-a8556205-d0a5-45e2-ac17-42d089e3c3f8.png"> </picture> </div> <div align="center"> <a href="https://habr.com/ru/companies/sberbank/articles/951800/">Habr</a> | <a href="https://kandinskylab.ai/">Project Page</a> | <a href="https://arxiv.org/abs/2511.14993">Technical Report</a> | 🤗 <a href=https://huggingface.co/collections/kandinskylab/kandinsky-50-video-lite> Video Lite </a> / <a href=https://huggingface.co/collections/kandinskylab/kandinsky-50-video-pro> Video Pro </a> / <a href=https://huggingface.co/collections/kandinskylab/kandinsky-50-image-lite> Image Lite </a> | <a href="https://huggingface.co/docs/diffusers/main/en/api/pipelines/kandinsky5"> 🤗 Diffusers </a> | <a href="https://github.com/kandinskylab/kandinsky-5/blob/main/comfyui/README.md">ComfyUI</a> </div> <h1>Kandinsky 5.0: A family of diffusion models for Video & Image generation</h1>

In this repository, we provide a family of diffusion models to generate a video or an image given a textual prompt and/or image.

https://github.com/user-attachments/assets/b06f56de-1b05-4def-a611-1a3159ed71b0

Kandinsky 5.0 Image Lite

Kandinsky 5.0 Image Lite is a line-up of 6B image generation models with the following capabilities:

• 1K resulution (1280x768, 1024x1024 and others).

• High visual quality

• Strong text-writing

• Russian concepts understanding

Model Zoo

*Latency was measured after the second inference run. The first run of the model can be slower due to the compilation process. Inference was measured on an NVIDIA H100 GPU with 80 GB of memory, using CUDA 12.8.1 and PyTorch 2.8. For 5-second models Flash Attention 3 was used.

Examples:

<table border="0" style="width: 200; text-align: left; margin-top: 20px;"> <tr> <td> <image src="https://github.com/user-attachments/assets/f46e6866-15ce-445d-bb81-9843a341e2a9" width=200 ></image> </td> <td> <image src="https://github.com/user-attachments/assets/74f3af1f-b11e-4174-9f36-e956b871a6e6" width=200 ></image> </td> <td> <image src="https://github.com/user-attachments/assets/7e469d09-8b96-4691-b929-dd809827adf9" width=200 ></image> </td> <tr> </table> <table border="0" style="width: 200; text-align: left; margin-top: 10px;"> <td> <image src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/d_tBhWrIgQZEZZewgOUxa.jpeg" width=200 ></image> </td> <td> <image src="https://github.com/user-attachments/assets/f4825237-640b-4b2d-86e6-fd08fe95039f" width=200 ></image> </td> <td> <image src="https://github.com/user-attachments/assets/73fbbc2a-3249-4b70-8931-2893ab0107a5" width=200 ></image> </td> </table> <table border="0" style="width: 200; text-align: left; margin-top: 10px;"> <td> <image src="https://github.com/user-attachments/assets/c309650b-8d8b-4e44-bb63-48287e22ff44" width=200 ></image> </td> <td> <image src="https://github.com/user-attachments/assets/d5c0fcca-69b7-4d77-9c36-cd2fb87f2615" width=200 ></image> </td> <td> <image src="https://github.com/user-attachments/assets/7895c3e8-2e72-40b8-8bf7-dcac859a6b29" width=200 ></image> </td> </table>

Results:

Side-by-Side evaluation

<table border="0" style="width: 200; text-align: left; margin-top: 20px;"> <tr> <td> <img width="200" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/S3yNpvgpr8DL8ikmywqqT.png" /></img> </td> <td> <img width="200" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/t44etk6Gu0N1aEQN3RpC_.png" /></img> </td> <tr> <td> Comparison with FLUX.1 dev </td> <td> Comparison with Qwen-Image </td> </table>

Kandinsky 5.0 Image Editing

Kandinsky 5.0 Image Editing is a line-up of 6B image editing models with the following capabilities:

• 1K resulution (1280x768, 1024x1024 and others).

• High visual quality

• Strong text-writing

• Russian concepts understanding

Model Zoo

*Latency was measured after the second inference run. The first run of the model can be slower due to the compilation process. Inference was measured on an NVIDIA H100 GPU with 80 GB of memory, using CUDA 12.8.1 and PyTorch 2.8. For 5-second models Flash Attention 3 was used.

Examples:

<table border="0" style="width: 400; text-align: left; margin-top: 20px;"> <tr> <td> <img width="400" alt="image" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/LspRVjY8VElTUXcF-d1-C.png" /></image> </td> <td> <img width="400" alt="image" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/82j0U5XF6ZrPhrjOSQhP0.png" /></image> </td> <tr> <td> Change this to a cowboy hat. </td> <td> Turn this into a neon sign hanging on a brick wall in a cool modern office. </td> </tr> <tr> <td> <img width="400" alt="image" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/Z09xzf6wnt3IsD8klQ6wF.png" /></image> </td> <td> <img width="400" alt="image" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/FKP9J9fnGHxZfv-cCphCo.png" /></image> </td> <tr> <td> Swap your sweatshirt for a se- quined evening dress, add some bright jewelry, and brighten your lips and eyes. Keep the angle. </td> <td> Turn this into a real photograph of the same dog. </td> </tr> </table>

Results:

Side-by-Side evaluation

<table border="0" style="width: 200; text-align: left; margin-top: 20px;"> <tr> <td> <img width="200" alt="image" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/kJrohAr4qQO3VzAH44YPi.png" /></img> </td> <td> <img width="200" alt="image" src="https://cdn-uploads.huggingface.co/production/uploads/678781c9e3c3c0163db4f99c/NHxnDp9pGNSNMH469u-d0.png" /></img> </td> <tr> <td> Comparison with FLUX.1 Kontext [dev] </td> <td> Comparison with Qwen-Image-Edit-2509 </td> </table>

Quickstart

Installation

Clone the repo:

git clone https://github.com/kandinskylab/kandinsky-5.git
cd kandinsky-5

Install dependencies:

pip install -r requirements.txt

To improve inference performance on NVidia Hopper GPUs, we recommend installing Flash Attention 3.

Model Download

python download_models.py

use models argument to download some specific models, otherwise all models will be downloaded

example to download only kandinskylab/Kandinsky-5.0-T2V-Lite-sft-5s and kandinskylab/Kandinsky-5.0-T2V-Pro-sft-5s:

python download_models.py --models kandinskylab/Kandinsky-5.0-T2V-Lite-sft-5s,kandinskylab/Kandinsky-5.0-T2V-Pro-sft-5s

Run Kandinsky 5.0 T2I Lite

python test.py --config ./configs/k5_lite_t2i_sft_hd.yaml --prompt "A dog in a red hat" --width=1280 --height=768

T2I Inference

import torch
from kandinsky import get_T2I_pipeline

device_map = {
    "dit": torch.device('cuda:0'), 
    "vae": torch.device('cuda:0'), 
    "text_embedder": torch.device('cuda:0')
}

pipe = get_T2I_pipeline(device_map, conf_path="configs/k5_lite_t2i_sft_hd.yaml")

images = pipe(
    seed=42,
    save_path='./test.png',
    text="A cat in a red hat with a label 'HELLO'"
)

I2I Inference

import torch
from kandinsky import get_I2I_pipeline

device_map = {
    "dit": torch.device('cuda:0'), 
    "vae": torch.device('cuda:0'), 
    "text_embedder": torch.device('cuda:0')
}

pipe = get_I2I_pipeline(
    resolution=1024, offload=True,
    device_map=device_map,
)
out = pipe(
    "Replace the cat with a husky, leave the rest unchanged",
    image='./assets/cat_in_hat.png'
)

Please, refer to examples folder for more examples in various notebooks.

Distributed Inference

For a faster inference, we also provide the capability to perform inference in a distributed way:

NUMBER_OF_NODES=1
NUMBER_OF_DEVICES_PER_NODE=1 / 2 / 4
python -m torch.distributed.launch --nnodes $NUMBER_OF_NODES --nproc-per-node $NUMBER_OF_DEVICES_PER_NODE test.py

Optimized Inference

Offloading

For less memory consumption you can use offloading of the models.

python test.py --prompt "A dog in red hat" --offload

Magcache

Also we provide Magcache inference for faster generations (now available for sft 5s and sft 10s checkpoints).

python test.py --prompt "A dog in red hat" --magcache

Qwen encoder quantization

To reduce GPU memory needed for Qwen encoder we provide option to use NF4-quantized version from bitsandbytes.

python test.py --prompt "A dog in red hat" --qwen_quantization

Attention engine selection

Depending on your hardware you can use the follwing full attention algorithm implementation:

• PyTorch SDPA
• Flash Attention 2
• Flash Attention 3
• Sage Attention

The attention algorithm can be selected using an option "--attention_engine" of test.py script for 5 second (and less) video generation. For 10-second generation we use sparse attention algorithm NABLA.

Note that currently (19 Oct. 2025) version build from source contains a bug and produces noisy output. A temporary workaround to fix it is decribed here.

python test.py --prompt "A dog in red hat" --attention_engine=flash_attention_3

python test.py --prompt "A dog in red hat" --attention_engine=flash_attention_2

python test.py --prompt "A dog in red hat" --attention_engine=sdpa

python test.py --prompt "A dog in red hat" --attention_engine=sage

By default we use option --attention_engine=auto which enables automatic selection of the most optimal algorithm installed in your system.

ComfyUI

See the instruction here

CacheDiT

cache-dit offers Fully Cache Acceleration support for Kandinsky-5 with DBCache, TaylorSeer and Cache CFG. Visit their example for more details.

Beta testing

You can apply to participate in the beta testing of the Kandinsky Video Lite via the telegram bot.

Authors

<B>Core Contributors</B>:

• <B>Video</B>: Alexey Letunovskiy, Maria Kovaleva, Lev Novitskiy, Denis Koposov, Dmitrii Mikhailov, Anastasiia Kargapoltseva, Anna Dmitrienko, Anastasia Maltseva
• <B>Image & Editing</B>: Nikolai Vaulin, Nikita Kiselev, Alexander Varlamov
• <B>Pre-training Data</B>: Ivan Kirillov, Andrey Shutkin, Nikolai Vaulin, Ilya Vasiliev
• <B>Post-training Data</B>: Julia Agafonova, Anna Averchenkova, Olga Kim
• <B>Research Consolidation & Paper</B>: Viacheslav Vasilev, Vladimir Polovnikov

<B>Contributors</B>: Yury Kolabushin, Kirill Chernyshev, Alexander Belykh, Mikhail Mamaev, Anastasia Aliaskina, Kormilitsyn Semen, Tatiana Nikulina, Olga Vdovchenko, Polina Mikhailova, Polina Gavrilova, Nikita Osterov, Bulat Akhmatov

<B>Track Leaders</B>: Vladimir Arkhipkin, Vladimir Korviakov, Nikolai Gerasimenko, Denis Parkhomenko

<B>Project Supervisor</B>: Denis Dimitrov

Citation

@misc{arkhipkin2025kandinsky50familyfoundation,
      title={Kandinsky 5.0: A Family of Foundation Models for Image and Video Generation}, 
      author={Vladimir Arkhipkin and Vladimir Korviakov and Nikolai Gerasimenko and Denis Parkhomenko and Viacheslav Vasilev and Alexey Letunovskiy and Nikolai Vaulin and Maria Kovaleva and Ivan Kirillov and Lev Novitskiy and Denis Koposov and Nikita Kiselev and Alexander Varlamov and Dmitrii Mikhailov and Vladimir Polovnikov and Andrey Shutkin and Julia Agafonova and Ilya Vasiliev and Anastasiia Kargapoltseva and Anna Dmitrienko and Anastasia Maltseva and Anna Averchenkova and Olga Kim and Tatiana Nikulina and Denis Dimitrov},
      year={2025},
      eprint={2511.14993},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2511.14993}, 
}

@misc{mikhailov2025nablanablaneighborhoodadaptiveblocklevel,
      title={$\nabla$NABLA: Neighborhood Adaptive Block-Level Attention}, 
      author={Dmitrii Mikhailov and Aleksey Letunovskiy and Maria Kovaleva and Vladimir Arkhipkin
              and Vladimir Korviakov and Vladimir Polovnikov and Viacheslav Vasilev
              and Evelina Sidorova and Denis Dimitrov},
      year={2025},
      eprint={2507.13546},
      archivePrefix={arXiv},
      primaryClass={cs.CV},
      url={https://arxiv.org/abs/2507.13546}, 
}

Acknowledgements

We gratefully acknowledge the open-source projects and research that made Kandinsky 5.0 possible:

• PyTorch — for model training and inference.
• FlashAttention 3 — for efficient attention and faster inference.
• Qwen2.5-VL — for providing high-quality text embeddings.
• CLIP — for robust text–image alignment.
• HunyuanVideo — for video latent encoding and decoding.
• MagCache — for accelerated inference.
• ComfyUI — for integration into node-based workflows.

We deeply appreciate the contributions of these communities and researchers to the open-source ecosystem.