uebox

Unreal Box（UE Box）は、Unreal Editorを直接操作するAI Agentとして位置づけられたオープンソースのデスクトップアプリケーションです。ユーザーがモデルサービスプロバイダーを設定すると、UnrealAgentLinkプラグインを通じて実行中のUnreal Editorに接続し、100以上のエンジンツールと25の内蔵スキルを活用してタスクを実行します：Actorの配置、ブループリントの変更、マテリアルの接続、C++のコンパイルなど。通常の操作は直接実行され、リスクのある操作は一時停止してユーザーの確認を待ちます。タスク完了後、Agentは読み取り専用ツールでエンジンに戻って変更を検証し、検出された問題に一つずつ回答します。 対象範囲はレベル、ブループリント、マテリアル、アセット、C++に加え、アニメーションリターゲット、UMG、Sequencerショット、PIE実行検証、ジオメトリ編集、プロジェクト診断も含みます。製品の主体はAgentであり、プロジェクトライブラリ、アセットライブラリ、ブループリントライブラリとマテリアルライブラリ、ノートとナレッジベースはそれぞれ独立したインターフェースを持ち、単独でも使用できますが、製品構造上はAgentにサービスを提供します：作用対象の登録、素材の提供、成果物の受け取り。 本リポジトリはコミュニティコア版です：アカウント不要、公式サーバー非依存、完全に自己ビルド可能です。 導入フロー：GitHub Releasesまたは公式サイトからダウンロードしてインストール（Windows）し、設定でモデルサービスプロバイダーを追加して自分のAPI Keyを入力し、デフォルトの会話モデルをそれに指定します。モデルはツール呼び出しをサポートする必要があります。ローカル推論（Ollama、LM Studio、llama.cpp）と自前ゲートウェイ（LiteLLM、One API）に対応しています。その後、プロジェクトライブラリに.uprojectをインポートすると、接続プラグインが自動的にプロジェクトのPlugins/UnrealAgentLink/ディレクトリにインストールされ、無効化または削除できます。プロジェクトを開くとプラグインが自動接続し、サイドバーのAIセッションでまず読み取り専用の質問（例：レベルの光源数）で接続を確認できます。 Codex、Claude Code、Cursorを使用したことがあるユーザーは、MCPスイッチをオンにしてUnreal Boxをツールサービスとして接続し、100以上のUEツールを取得できます。MCPはローカルマシンからのみ接続可能で、トークンが必要、デフォルトで書き込み可能です。 ネットワークとデータについて：アカウントを使用せず、キーはローカルに暗号化保存され、リクエストはユーザーが設定したサービスプロバイダーに直接送信され、プロジェクト側のサーバーを経由しません。デフォルトでは更新チェックのみでダウンロードは行いません。自己パッケージングし更新ソースを未設定のビルドはネットワークリクエストを発行しません。AI、オンライン検索、画像生成、クラウドストレージなどの機能は必要に応じて接続され、ローカルモデル使用時はAIデータがマシン外に出ません。 プラットフォーム対応：Windowsはインストーラーを提供し、エンジン検出とプリコンパイル済みUnrealAgentLinkプラグインをサポートする主力プラットフォームです。macOSはソースコードビルドが必要で、一般的な共有インストールディレクトリ内のエンジンをスキャンでき、エンジンディレクトリやエディタ.appを手動追加することもでき、実行中のUE4/UE5エディタとそのプロジェクトパスを検出できますが、プリコンパイルプラグインのビルドとリリース検証は未完了です。Linuxはソースコードビルドが必要で、エンジン検出は未対応です。 技術スタックはElectron + Vue 3 + TypeScriptで、Unreal Engine 5.0から5.8まで対応しています。ソースコードから実行する場合はpnpm installとpnpm devを使用します。コミット前にpnpm verifyを実行すると、1つのコマンドでキースキャン、lint、変更行lint、型チェック、ユニットテストを実行でき、アプリケーション実行中でも実行可能です。リポジトリはAIコーディングアシスタント向けのAGENTS.md仕様と検証ゲートを提供しており、ユーザーは自然言語で要件を記述し、AIアシスタントにアーキテクチャを読ませ、コードを変更させ、テストを補完させ、検証を実行させることができます。 ライセンス：アプリケーションはApache License 2.0を採用し、UnrealAgentLinkプラグインのソースコードはplugin/UnrealAgentLinkにあり、独立したMITライセンスを採用しています。Unreal EngineはEpic Games, Inc.の商標であり、本プロジェクトはEpic Gamesと提携関係はありません。