4dgspl.at — 4D Gaussian Splatting

4dgspl-tools

4dgspl.atで**4D Gaussian Splatting（4DGS）**コンテンツを作成するためのオープンツールです。3Dモデル、アニメーションキャラクター（Mixamoのものなど）、またはBlenderシーンを、正確なCOLMAPキャリブレーション付きの同期マルチカメラレンダーに変換し、検証して、ブラウザーで再生できる4DGSシーケンスに変換します。

AI コーディングエージェント（Claude Code、Codexなど）だけでなく、人も使えるように作られています。エージェントは、まずAGENTS.mdをご覧ください。

ツール	機能
tools/4dgspl_blender_rig.py	Blender：シーンの周囲に4～16台のカメラリング（8台、2つの高さを推奨）を構築し、各カメラからcam00.mp4 …をレンダリングして、COLMAPのcameras.txtとimages.txt（kalibrasyon.zip）を書き込みます。デフォルトではワールドは完全な黒です。
tools/4dgspl_yukle.py	エージェントキー（DGSPL_ANAHTAR）用の依存関係不要のアップロードクライアントです。検証、プロジェクト作成、アップロード、送信、待機を行い、フレームごとの3DGS結果をダウンロードします：--gonder --bekle --indir result。
tools/4dgspl_mcp.py	依存関係不要のMCP サーバー（stdio）です。Claude Code、Codex、Cursor、Claude Desktopから、4dgspl.atの各機能をツールとして利用できます：get_4dgs_guide、check_delivery、upload_project、submit_project、project_status、list_projects、download_result。
tools/4dgspl_kontrol.py	アップロード前のチェックツールです。動画の名前、解像度、fps、フレーム数、キャリブレーションの形式とピクセル単位、カメラが共通の中心を向いているか、高さのバリエーションやリングの隙間、背景が黒かどうかを確認します。--jsonで出力し、エラー時の終了コードは1です。

クイックスタート

# 1. Camera ring + render + calibration (Blender 4.x)
blender -b scene.blend -P tools/4dgspl_blender_rig.py -- --kamera 8 --yaricap 3.5 --cikti //teslim --render

# 2. Validate
python3 tools/4dgspl_kontrol.py teslim

# 3. Upload, process and download with your agent key (4dgspl.at → Projelerim → Ajan anahtarları)
export DGSPL_ANAHTAR=4dg_…
python3 tools/4dgspl_yukle.py teslim --gonder --bekle --indir result

キャリブレーションファイルのない実写映像の場合は、--colmapを追加してください（カメラは8台以上、間隔は最大45°、シーンにはテクスチャが必要です）。

特に重要なルール：

• **背景：**ワールドを完全な黒（0, 0, 0）にします。
• **マテリアル：**マットにします。
• **カメラ：**最低6台、8台を推奨します。カメラは動かしません。
• **タイミング：**主要な動きは最初の10秒以内に収めます。
• **フレーミング：**被写体がフレームの高さの70～85 %を占めるようにします。

詳細：エージェントガイド · 撮影ガイド · サンプル · llms.txt

エージェントスキル

skills/4dgs-blender/SKILL.mdでは、ワークフロー全体をエージェントスキルとしてまとめています。1つのBlenderシーンから、GLB 3Dアニメーション、動画、静止画像、4DGS動画を作成できます。Claude Codeにインストールするには、フォルダーを~/.claude/skills/にコピーしてください。各自のスキルフォルダーからSKILL.mdを読み込むエージェントは、同じファイルを使用できます。

MCP サーバー

mkdir -p ~/.4dgspl && cd ~/.4dgspl && curl -O https://4dgspl.at/araclar/4dgspl_mcp.py \
  -O https://4dgspl.at/araclar/4dgspl_yukle.py -O https://4dgspl.at/araclar/4dgspl_kontrol.py
claude mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py   # Claude Code
codex mcp add 4dgspl --env DGSPL_ANAHTAR=4dg_… -- python3 ~/.4dgspl/4dgspl_mcp.py    # Codex

• Claude Desktop： 最新リリースから4dgspl.mcpbをインストールし、設定でキーを入力します。
• その他のクライアント：コマンドにpython3、引数に4dgspl_mcp.pyのパス、環境変数にDGSPL_ANAHTARを指定します。
• キーがなくても、get_4dgs_guideとcheck_deliveryは引き続き使用できます。
• MCP Registryにはio.github.snmzzcenk/4dgsplとして登録されています（server.json）。python3 mcpb/build.pyでバンドルをビルドします。

出力

4dgspl.atは各フレームを3D Gaussian Splattingシーン（gsplat）として再構成します。出力は次のとおりです：

• PlayCanvas形式のcompressed.plyシーケンス；
• フレーム数、fps、開始カメラ、メトリクスを含むsahne.json；
• MP4プレビュー。

PlayCanvasでシーケンスをブラウザー再生するか、SuperSplatで単一フレームを開きます。

トルコ語

4dgspl.atで4D Gaussian Splattingコンテンツを作成するためのオープンツールです。Blenderリグスクリプトは4～16台のカメラリングを構築し、各カメラからレンダリングして、COLMAPキャリブレーションを書き込みます。チェッカーは、エンジンのルールに従ってアップロード前に納品物を検証します（--dil tr）。AIエージェント向けのワークフロー：https://4dgspl.at/ajan.html

このリポジトリ内のツールはhttps://4dgspl.at/araclar/ のコピーです。サイトが正式な提供元であり、ツールは同期されています。MITライセンス。