Официальный репозиторий: github.com/SamuelTallet/ZPix

Прямая ссылка на релизы и сборки: github.com/SamuelTallet/ZPix/releases

Лицензия: GPL-3.0 (открытый исходный код)

1. Главная идея: это современный «духовный наследник» Fooocus

Те, кто работал с нейросетями, помнят Fooocus, легендарную программу, которую полюбили за принцип «никаких узлов, никаких консолей, просто удобный холст, работающий прямо из коробки». Автор ZPix прямо подтверждает, что именно Fooocus служил для него главным источником вдохновения.

Но к сожалению, Fooocus остановился на эпохе SDXL. Новые флагманские модели (FLUX, Qwen-Image, Anima) в основном требовали либо тяжелого паутинного ComfyUI, либо платных облаков.

Программа переносит ту самую философию Fooocus на новейшие открытые модели: главный плюс в том, что программа сама разворачивает Python и нужные пакеты через быстрый менеджер uv. Не нужно возиться с масками шума, денойзом или отдельными inpaint-чекпоинтами. Вы просто выделяете область привычным графическим инструментом (как в Photoshop или Fooocus), пишете, что изменить, и нейросеть бесшовно перерисовывает  выбранный фрагмент.

Пиксели за пределами вашего выделения вообще не затрагиваются, нет замыливания всего кадра, характерного для обычного img2img.

2. Программа изначально оптимизировалась под обычные пользовательские компьютеры, а не серверные фермы.

И соответственно требования к «железу» относительно невысокие

GPU: Видеокарты NVIDIA RTX 30 / 40 / 50 серии с объемом от 8 ГБ VRAM. Также нативно поддерживаются чипы Apple Silicon (M1–M4) с унифицированной памятью.

ОЗУ (RAM): Рекомендуется 32 ГБ. На 16 ГБ программа работает, но на этапах первичной распаковки и смены моделей активнее задействуется файл подкачки.

Диск: от 25 ГБ свободного места на SSD (зависит от того, сколько моделей вы решите опробовать).

ОС: Windows 10/11, дистрибутивы Linux (Ubuntu/Debian), macOS.

Переход на алгоритмы FlashAttention предотвращает резкие пиковые утечки памяти (VRAM spikes) при генерации на нестандартных и ультрашироких соотношениях сторон.

3. Установка по шагам (Zero Config)

Windows

Зайдите в релизы проекта и скачайте архив ZPix_x.x.x_Windows.zip.

Распакуйте папку из архива в корень диска или каталог без пробелов и русских букв (например, C:\ZPix или D:\AI\ZPix).

Запустите файл ZPix.exe.

Предупреждение Windows SmartScreen: нажмите «Подробнее» - «Выполнить в любом случае».

Если пишет об отсутствии DLL: установите официальный пакет Visual C++ Redistributable.

При первом старте ZPix самостоятельно развернет изолированную среду Python и загрузит стартовую модель. Ничего нажимать в консоли не нужно, просто дождитесь открытия окна.

macOS (Apple Silicon)

Скачайте файл ZPix_x.x.x_AppleSilicon.dmg.

Перетащите ZPix в папку Applications («Программы»).

Если macOS блокирует приложение стороннего разработчика: перейдите в «Системные настройки» - «Конфиденциальность и безопасность» и нажмите «Подтвердить вход» (Open Anyway).

Linux (Ubuntu / Debian)

Скачайте установочный пакет zpix_x.x.x_all.deb.

Установите командой:

sudo apt install ./zpix_*.deb

Запустите ярлык ZPix из списка установленных программ.

4. Как скачиваются модели (Lazy Download)

Вам не нужно вручную искать файлы весов на Hugging Face и раскидывать их по папкам. В ZPix реализована отложенная загрузка:

При первом старте скачивается только базовая легковесная модель.

Любая другая модель подтягивается автоматически в тот момент, когда вы впервые выбираете её в верхнем списке.

Все веса кэшируются в стандартную системную папку:

Windows: C:\Users\<Пользователь>\.cache\huggingface\hub

Linux / macOS: ~/.cache/huggingface/hub

Доступные архитектуры:

FLUX.1 [dev] максимальный фотореализм, точность пальцев, текста и сложных сцен.

FLUX.2 [klein] 4B быстрая модель, оптимизированная специально под редактирование и инпейнтинг.

Z-Image Turbo сверхбыстрая модель с низким числом шагов.

Anima Turbo / Base стилизованные кинематографичные сцены (построена на архитектуре NVIDIA Cosmos).

Krea 2 Turbo скоростной движок для генерации и img2img.

Семейство Qwen-Image 2.1 (Base / Turbo / Pruna) отличные модели от Alibaba с глубоким пониманием сложных пространственных промптов.

5. Полный разбор интерфейса и каждого элемента

5.1. Холст и строка ввода запроса (Prompt Bar)

Поле ввода текста: Описание желаемой сцены или изменений (очень рекомендуется писать на английском).

Кнопка «Generate Image»: Запуск процесса генерации/правки.

Drag & Drop метаданных (Prompt Extraction): Если перетащить файл любого изображения, ранее созданного в ZPix (из папки на диске или из внутренней галереи приложения), прямо в текстовое поле, программа мгновенно извлечет из него исходный промпт, сид и параметры генерации.

Кнопки «Copy Prompt» / «Reuse»: Быстро скопировать запрос в буфер или переиспользовать параметры отображаемого на экране кадра.

5.2. Соотношение сторон (14 пресетов)

Выпадающее меню форматов исключает ручной ввод разрешения в пикселях:

1:1 (квадрат)

Горизонтальные: 16:9, 4:3, 5:4, 3:2, 16:10, 21:9 (ultrawide), 2:1

Вертикальные: 9:16, 3:4, 4:5, 2:3, 10:16, 9:20

5.3. Графические инструменты Inpainting (в стиле Fooocus / Photoshop)

На панели слева расположены инструменты ручного выделения области:

Lasso (Обычное лассо): Свободное рисование произвольного контура мышью.

Polygonal Lasso (Многоугольное лассо): Пошаговое выделение кликами от угла к углу.

Rectangle (Прямоугольник): Быстрая прямоугольная рамка.

Ellipse (Эллипс): Круглое или овальное выделение.

Hi-Res Fix (тумблеры 1.5x, 2x): Функция апскейла внутри выделенной области. Решает проблему размытия: если вы меняете маленький объект (например, кольцо на руке или зрачки глаз), нейросеть прорисует эту заплату с повышенной четкостью.

5.4. Подключение стилей и персонажей (LoRA)

Иконка LoRA открывает проводник.

Поддерживаются стандартные файлы .safetensors (с Civitai или Hugging Face).

Hot-swap: LoRA подключается и выгружается на лету, перезапускать ZPix не требуется.

Слайдер силы (Strength): Регулирует степень влияния LoRA от 0.0 до 1.0+.

Auto-triggers: Если в метаданных файла LoRA есть ключевые слова активации, программа сама вставит их в ваш промпт.

Важно: LoRA должна подходить под выбранную модель (LoRA для FLUX.1 не заработает на Qwen).

5.5. Дополнительные настройки (Иконка слайдеров ⚙️)

Steps: Количество шагов сэмплирования (для базовых моделей).

CFG Scale: Строгость следования промпту.

Seed: Числовое зерно генерации. Клик по игральной кости 🎲 возвращает случайный режим (Random Seed).

5.6. Автосохранение и корзина Discarded

Все результаты сохраняются в системную папку: Изображения/ZPix (Pictures/ZPix). При использовании LoRA результаты автоматически раскладываются по именным подпапкам.

Иконка папки с шестеренкой позволяет назначить любое другое место на диске.

Если во время работы вы нажимаете удаление картинки, она не стирается безвозвратно, а отправляется в подпапку Discarded внутри каталога сохранения (чтобы всегда можно было восстановить случайно удаленный удачный дубль).

6. Как работать: 

Сценарий 1. Генерация с нуля (Text-to-Image)

В верхнем меню выберите модель (например, FLUX.1 [dev] для фотореализма или Z-Image Turbo для быстрой генерации).

Выберите соотношение сторон (например, 16:9).

Напишите промпт (например: cinematic shot of an astronaut walking in a neon jungle, volumetric lighting, 8k, photorealistic).

Нажмите «Generate Image».

Сценарий 2. Работа по референсу (Image-to-Image)

Перетащите любое фото или скетч на холст из проводника или внутренней галереи.

В промпте напишите, во что его преобразовать.

Нажмите «Generate Image».

Сценарий 3. Редактирование и инпейнтинг (Inpainting в стиле Fooocus)

Откройте сгенерированное или загруженное изображение.

Выберите слева Lasso (горячая клавиша L) или Rectangle (M).

Обведите область, которую нужно переделать (например, лицо, одежду или объект на фоне). Совет: захватывайте область с небольшим запасом, чтобы модель лучше видела окружающий контекст.

В строке промпта опишите только то, что должно быть внутри выделения.

Для мелких деталей активируйте тумблер Hi-Res fix (1.5x или 2x).

Нажмите «Generate Image». Заменится только выделенная зона, а остальная картинка останется попиксельно нетронутой.

7. Горячие клавиши и решение проблем

L — активировать инструмент Lasso.

M — прямоугольное выделение (Rectangle).

F — переход в полноэкранный режим (Fullscreen).

Esc — снять текущее выделение с холста.

Возможные ошибки:

Не хватает видеопамяти (CUDA Out of Memory): переключитесь на модели FLUX.2 [klein] 4B или Z-Image Turbo, они используют SDNQ-квантование и свободно укладываются в 8 ГБ VRAM.

Как посмотреть причину вылета (Debug Mode): полностью закройте ZPix. В папке рядом с ZPix.exe создайте пустой файл с именем DEBUG (без расширения .txt). Запустите программу, теперь параллельно с ней останется открытой консоль с подробным логом ошибок.