shader-agent

Shader Agentは、シェーダーの生成、レビュー、検証、およびエクスポートにおいて、再現可能でオフライン対応のワークフローを必要とするクリエイターやメンテナー向けに設計されたローカルファーストのソフトウェアツールキットです。Python CLI、ローカルWeb UI、FTS5サポート付きSQLiteからのリファレンス取得、ライセンスを考慮したフィルタリング、レンダリング検証ゲート、およびShadertoy、WebGL、LÖVE 2D、オフラインビデオ制作などのプラットフォーム向けエクスポートヘルパーを組み合わせて提供します。 本ツールは、デフォルトで外部APIキーを必要とせずに決定論的なGLSLドラフト生成をサポートします。オプションのAI生成は、環境変数またはセッションのみのUI入力経由で有効にでき、OpenAI互換、OpenAI、Anthropic、Gemini、Ollamaのプロバイダーをサポートしています。ユーザーは、モデル、ベースURL、リトライ、キャッシュ、並行数などのAI設定を環境変数を通じて構成でき、実際のキーをコミットすることはありません。 主な機能には、JSONLからのシェーダーメタデータ/コードの取り込み、レンダリングフィードバックを伴う複数候補の反復生成、構文、mainImageの形状、ライセンス準拠、およびスモークテストのためのプリフライトチェック、そしてShadertoyおよびLÖVE 2Dと互換性のあるエクスポートパッケージが含まれます。Web UIでは、ライブWebGLプレビュー、編集可能なコード、非破壊的な反復のためのノードグラフ、および構成可能なFPS、解像度、ミキシングによるフレームまたはビデオのエクスポートコントロールが提供されます。 また、プロジェクト化された出力、リファレンス監査、および /search、/export、/repair-ai などのコマンドを備えたCLIチャットモードが含まれています。アーキテクチャはモジュール式となっており、コマンドラインエントリ用の cli.py、ローカルサーバー用の webapp.py、オーケストレーション用の agent.py、ストレージ/検索用の store.py、プロバイダールーティング用の llm.py、検証ゲート用の quality.py、およびプラットフォーム固有のアダプター用の targets/ で構成されています。 本プロジェクトは、BilibiliおよびYouTubeで公開されたシェーダーベースのVFXビデオ22エピソードの制作に使用されており、単発の実験を超えた長期的な実用的利用が実証されています。テストには、ユニットテスト、アクセプタンススクリプト、およびブラウザUI検証が含まれます。ufbxなどのサードパーティコンポーネントはMITライセンスの下でバンドルされています。 セキュリティガイダンスでは、APIキー、プライベートプロンプト、生成されたメディア、およびデータベースをパブリックなIssueやPRに含めないことを強調しています。ロードマップには、パブリックリポジトリの公開、CIバッジの追加、スクリーンショット/GIFのホスティング、レンダリング検証の改善、および重いテストと高速なPRチェックの分離が含まれています。MITライセンスの下でリリースされています。