Mixar-AI/mixar-app

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)はすべてオフラインで動作します。


はじめに / ソースからのビルド

  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 – 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 サービス自体はプロプライエタリのままです。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト