Mixar

Mixar 是一个开源的桌面应用程序，通过 AI 驱动的工作流程扩展了 Blender 5.2，用于 3D 创作。它包含了完整的 Blender 功能集，并添加了：

• AI 聊天代理（Mixie） – 您可以输入自然语言命令来建模、纹理、修复 UV、设置材质等。
• 基于图层的纹理绘制 – Photoshop 风格的堆叠图层、蒙版、程序化材质、UDIM 支持和资源导出。
• AI 辅助 3D 生成 – 文本到 3D 和图像到 3D 网格生成（通过 Hunyuan 或其他模型），并自动重拓扑和 UV 展开。
• 情绪板驱动的场景创建 – 拖入参考图像，让 AI 构建完整场景。
• 资源搜索 – 在本地库中进行神经嵌入搜索。
• 自带密钥（BYOK） – 可选地将聊天代理路由到您自己的 OpenAI/Anthropic API 密钥，而不是使用 Mixar 的托管积分。
• 原生 Mixar 编辑器空间 – 在 Blender UI 中为图层、属性、资源和聊天提供专用面板。

AI 功能与 Mixar 的闭源后端通信（需要免费的 Mixar 账户），但所有非 AI 部分（雕刻、动画、渲染、分层绘制模块、文件 I/O）均可离线工作。

---

入门 / 从源码构建

1. 克隆 仓库（递归，包含 Blender 源码作为子模块）：

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

2. 初始化 子模块和 LFS 资源：

   make init
   

3. 配置 环境（复制示例并编辑您需要的后端 URL）：

   cp .env.example .env
   $EDITOR .env
   

4. 构建 整个应用程序（覆盖层 + CMake + 编译）：

   make build   # 默认为 Prod（发布）构建
   

   生成的二进制文件位于 build/<env>/bin/ 下（例如 build/Prod/bin/mixar）。
5. 运行 它：

   make run          # 启动 Dev 构建
   make run Prod     # 启动生产构建
   

平台说明

• Linux – 安装 README 中列出的长串开发包，使用 GCC 14/G++ 14，如果没有 CUDA/OptiX，请设置 MIXAR_CUDA=0。
• macOS – 需要 CMake（Homebrew 或应用程序包）和标准的 Xcode 工具链。
• Windows – 需要 Visual Studio 2022 17.14+ 并带有 C++ 工作负载；构建脚本处理覆盖层和 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 服务本身保持专有。