Представьте: вы открываете фото своего персонажа в Pinterest, делаете два клика в терминале — и через 20 секунд у вас на диске лежит текстурированный 3D-меш, готовый к импорту в Blender или Unity. Звучит как фантастика? Ещё год назад для такого нужна была видеокарта за 200 тысяч и танцы с бубном вокруг CUDA. Сегодня это делает обычный MacBook Air на M1 с 8 ГБ памяти. Встречайте Hunyuan3D-Paint — open-source инструмент, который теперь работает на Apple Silicon через MLX.
Чем Hunyuan3D-Paint отличается от обычного Hunyuan3D?
Всё просто: обычный Hunyuan3D генерирует только геометрию (обычно в виде облака точек или меша без текстур). Чтобы получить покрашенную модель, приходилось прогонять результат через отдельные программы-текстуровщики (типа Instant NGP или заплатки от Stable Diffusion). Hunyuan3D-Paint делает это сразу: на входе — изображение, на выходе — полноценный OBJ/GLB файл с UV-развёрткой и натянутой текстурой.
Внутри — два этапа: сначала модель строит каркас (те же 10–15 секунд), а затем за 5–7 секунд натягивает текстуру, используя diff-модуль, обученный на парах «изображение — 3D-текстура». На практике это выглядит как магия: даже размытые фотографии превращаются в модели с детализированными цветами.
| Параметр | Hunyuan3D 2 Mini | Hunyuan3D-Paint |
|---|---|---|
| Что на выходе | Меш без текстур (или с одной цветной) | Текстурированный меш (UV + цвет) |
| Время генерации (M1 16GB) | ~15 сек | ~20–25 сек |
| RAM (минимальная) | 6 ГБ | 8 ГБ |
| Поддержка MLX | Да (с недавних пор) | Да (нативный порт) |
Как это работает на практике: пошаговая инсталляция
Лучшее в порте для Apple Silicon — не надо ставить Python окружение с CUDA. Всё ставится через одну команду, а модель весит всего 2.3 ГБ (в 4-битном квантовании). Давайте пройдёмся по шагам.
1 Подготовка: установите Swift и MLX
Убедитесь, что у вас стоит macOS 14.0+ и Xcode 16 (или хотя бы Command Line Tools). Если нет — скачайте с официального сайта Apple. Дальше:
# Клонируем репозиторий MLX-порта
git clone https://github.com/mlx-community/hunyuan3d-paint.git
cd hunyuan3d-paint2 Скачиваем веса модели
Скрипт сам загрузит квантованные веса. Если хотите сэкономить трафик — веса можно скачать вручную с Hugging Face (ссылку найдёте в README проекта).
swift run download-weights
# Ждём пару минут — модель весит ~2.3 ГБ⚠️ Не путайте с обычной PyTorch-версией — MLX-порт использует собственный формат весов. Если вы пробовали запускать TRELLIS.2 на Mac, то процедура похожая.
3 Генерируем 3D из изображения
Всё, что нужно — передать путь к картинке. Результат появится в папке output/.
swift run generate --image ~/Pictures/my_character.png \
--output ~/3D_models \
--format glb
# Через 20-25 секунд смотрите результатЕсли у вас мало оперативной памяти (8 ГБ) — добавьте флаг --low-memory. Тогда генерация займёт на 5–7 секунд дольше, но модель уложится в 6 ГБ RAM. Работает на M1 MacBook Air без единого вылета.
Сравнение с альтернативами для Mac
До появления этого порта на Apple Silicon можно было запустить либо Trellis.2 (через MLX, но с результатом без текстур), либо древние решения вроде Zero-1-to-3 (через PyTorch с чудовищным потреблением памяти). Hunyuan3D-Paint выигрывает по скорости и качеству текстурирования. Единственный серьёзный конкурент — кастомная сборка на основе Hunyuan3D с дополнительным модулем текстурирования (собранная вручную), но там нужно больше телодвижений.
Ключевое преимущество Hunyuan3D-Paint — он не требует GPU NVIDIA, что редкость для 3D-моделей. Всё считается на нейронных ядрах (ANE) и GPU Apple через MLX. Сравните:
| Инструмент | Текстуры | Время на M1 Pro | RAM | Сложность запуска |
|---|---|---|---|---|
| Hunyuan3D-Paint (MLX) | ✅ | 20–25 сек | 8 ГБ | ⭐ (одна команда) |
| TRELLIS.2 (MLX) | ❌ (только геометрия) | 15–18 сек | 6 ГБ | ⭐⭐ (два шага) |
| Instant NGP (PyTorch) | ✅ | 5–10 мин | 12+ ГБ | ⭐⭐⭐⭐ (много зависимостей) |
Кому это реально нужно (и не нужно)
Идеально для:
- Инди-геймдевов — быстро набросать прототип персонажа или предмета из референса.
- Дизайнеров интерьеров — сфотографировали мебель в магазине, через минуту уже крутите её в 3D.
- Владельцев Mac с малым объёмом RAM — 8 ГБ хватает, что редкость для 3D-генерации.
- Фанатов open-source — никаких API, никаких дырявых приватных данных.
Для кого не подойдёт:
- Если вам нужна промышленная детализация (миллионы полигонов) — модель выдает меш с ~10–50K треугольников. Для AAA-игр придётся дорабатывать вручную.
- Если вы не готовы работать с терминалом — пока нет GUI (но, возможно, появится в сентябрьском обновлении).
- Если у вас Intel Mac — порт только для Apple Silicon.
И да, если вам хочется не просто 3D, а целую анимацию — советую посмотреть в сторону генерации анимаций через Qwen 3.6. Это другой класс задач, но тоже работает локально.
Пара неприятных моментов (честно)
Работает не идеально с людьми — лица часто получаются размытыми, пальцы слипаются. Это общая проблема image-to-3d моделей, Hunyuan3D-Paint здесь не исключение. Лучшие результаты — на предметах, животных (без сложной геометрии) и архитектуре. Для персонажей в стиле стилизованной мультяшности — почти отлично.
Ещё: текстуры генерируются в формате PNG (1K или 2K в зависимости от флага). Если нужно 4K — придётся апскейлить отдельно. Но для веба и мобильных игр — самое то.
Что дальше?
Судя по тому, как быстро портируют 3D-модели на MLX (за последние полгода — Trellis.2, Hunyuan3D Mini, а теперь и Paint), через год мы будем удивляться не тому, что нейросеть работает на Mac, а тому, как мы вообще жили без этого. Если у вас завалялся старый MacBook с M-чипом — не продавайте его. 3D-генерация превращает его в мини-фабрику ассетов.
Совет на посошок: сохраните пару картинок из Pinterest с простыми формами — кружка, стул, кактус. Запустите Hunyuan3D-Paint, посмотрите на результат. Если через 5 минут вам не захочется сгенерировать ещё десяток — значит, вы робот.
