AI-powered 3D suite built on Blender, with an integrated agent, moodboard, generation tools and layer-based painting

Mixar

Mixar는 AI 기반 3D 제작 워크플로우로 Blender 5.2를 확장하는 오픈소스 데스크톱 애플리케이션입니다. 전체 Blender 기능 세트를 포함하며 다음을 추가합니다:

AI 채팅 에이전트(Mixie) – 자연어 명령을 입력하여 모델링, 텍스처, UV 수정, 재질 설정 등을 수행할 수 있습니다.
레이어 기반 텍스처 페인팅 – Photoshop 스타일의 스택 레이어, 마스크, 절차적 재질, UDIM 지원 및 자산 내보내기.
AI 지원 3D 생성 – 텍스트-3D 및 이미지-3D 메시 생성(Hunyuan 또는 기타 모델 사용), 자동 리토폴로지 및 UV 언랩 포함.
무드보드 기반 장면 생성 – 참조 이미지를 드롭하고 AI가 전체 장면을 구축하도록 합니다.
자산 검색 – 로컬 라이브러리 전체에서 신경 임베딩 검색.
Bring-your-own-key(BYOK) – 채팅 에이전트를 Mixar의 호스팅 크레딧 대신 자체 OpenAI/Anthropic API 키로 라우팅하는 옵션.
네이티브 Mixar 편집기 공간 – Blender UI 내의 레이어, 속성, 자산, 채팅 전용 패널.

AI 기능은 Mixar의 비공개 소스 백엔드와 통신합니다(무료 Mixar 계정 필요). 그러나 모든 비 AI 부분(조각, 애니메이션, 렌더링, 레이어 페인트 모듈, 파일 I/O)은 오프라인에서 작동합니다.

시작하기 / 소스에서 빌드

저장소를 재귀적으로 클론합니다(Blender 소스가 서브모듈로 포함됨):

git clone --recursive https://github.com/Mixar-AI/mixar-texture-painting.git
cd mixar-texture-painting

서브모듈 및 LFS 자산을 초기화합니다:
```
make init
```
환경을 구성합니다(예제를 복사하고 필요한 백엔드 URL을 편집):
```
cp .env.example .env
$EDITOR .env
```
전체 애플리케이션을 빌드합니다(오버레이 + CMake + 컴파일):
```
make build   # 기본값은 Prod(릴리스) 빌드
```
생성된 바이너리는 build/<env>/bin/ 아래에 배치됩니다(예: build/Prod/bin/mixar).

실행합니다:

make run          # Dev 빌드 실행
make run Prod     # 프로덕션 빌드 실행

플랫폼별 참고 사항

Linux – README에 나열된 긴 개발 패키지 목록을 설치하고, GCC 14/G++ 14를 사용하며, CUDA/OptiX가 없는 경우 MIXAR_CUDA=0을 설정합니다.
macOS – CMake(Homebrew 또는 앱 번들)와 표준 Xcode 툴체인이 필요합니다.
Windows – C++ 워크로드가 포함된 Visual Studio 2022 17.14+가 필요합니다. 빌드 스크립트가 오버레이와 CMake 구성을 처리합니다.

빠른 테스트

python -m pip install pytest Pillow numpy
python -m pytest -q   # bpy를 스텁하는 순수 Python 테스트 실행

스모크 테스트(tests/qa/linux_build_smoke.py)는 백엔드 계정 없이 실행할 수 있으며, 앱이 시작되고, 장면을 로드하고, 작은 CPU Cycles 패스를 렌더링하고, 결과를 저장하는지 확인합니다.

라이선스

Mixar 고유 코드: GPL-3.0 이상.
수정된 Blender 파일: GPL-2.0 이상(업스트림에서 상속).
ucupaint 프로젝트에서 파생된 부분: GPL-3.0 이상, 출처 표시 포함.
브랜드 자산에는 별도의 비 GPL 브랜드 라이선스가 있습니다.

모든 파일에는 SPDX 헤더가 포함되어 있으며 저장소는 REUSE 사양을 따릅니다.

프로젝트 상태

버전 2.0.0 – 첫 공개 소스 릴리스, Blender 5.2 기반.
데스크톱 앱 소스는 완전히 제공됩니다. AI 백엔드는 비공개 소스로 유지됩니다.
기여는 아직 열려 있지 않지만(CLA 프로세스 보류 중), 버그 보고 및 빌드 도움 질문은 GitHub Issues 또는 Discord 커뮤니티를 통해 환영합니다.

도움말 / 커뮤니티

Discord: https://discord.gg/YVqvkQx8rX (빌드 도움 및 사용 질문에 가장 빠른 곳)
GitHub Issues: 재현 가능한 버그, 빌드 문제, 라이선스 질문용.
호스팅 서비스: https://mixar.app 에서 로그인하여 AI 크레딧, 계정 관리, 공식 지원을 받으세요.

요약: Mixar는 아티스트에게 친숙한 Blender 환경을 제공하며, AI 채팅 기반 모델링, 텍스처 페인팅 레이어, 생성적 3D 기능을 강화하면서 전체 Blender 워크플로우를 유지합니다. 소스 저장소에는 데스크톱 클라이언트를 컴파일하는 데 필요한 모든 것이 포함되어 있지만, AI 서비스 자체는 독점으로 유지됩니다.

Mixar-AI/mixar-app