DanceFlow

人とエージェントのためのDanceFlow

Kieran Simkinのウェブサイト · DanceFlowエコシステム · ソースと貢献

17種類の、それぞれ単独でも役立つ音楽、モーション、メディアツールのためのポータブルな手順と、エコシステム全体の探索機能、型付き実行アダプター、ネイティブなStemLab MCP構成、ブラウザー／WordPressホストの明示的な要件を備えたローカルMCPハブです。このツールキットは、エージェントが既存の機能を選び、確認可能な成果物を作成し、小規模でテスト済みの改善を加えられるよう支援します。

新しいワークフローを始める前に

開始前に、最新の安定版公式リリースと実際にインストール／インポートされているバージョンを確認してください。ディレクトリ名や開発チェックアウトから最新の状態を推測しないでください。最新のリリースノート、タグ付きの機能ドキュメント、関連するPotential problemsを確認してください。DanceFlowリリースの事前確認と機能リファレンスの完全版を参照してください。

人とエージェントはエコシステム全体を検討し、タスクに実質的に役立つ機能をすべて使い、サポート対象のファイル／APIを組み合わせ、再利用可能な不足が実証された場合は、その正規のツールを改善してください。価値のある変更が不要と判断した場合は、その理由を記録してください。各ツールの独立性、互換性、ソースの時間情報、プライバシー、モデルのダウンロードコスト、公開／デプロイの権限を損なわないでください。重みとモデル固有のキャッシュは、所有するプロジェクトの無視対象ディレクトリmodels/に保存してください。

ワークフローリファレンスの完全版

リリース済み機能インデックスの完全版、リリースの事前確認、FrameRudimentsコンポジターワークフローの完全版を参照してください。インストール済みのdanceflow-releases --output NEW-RUN/releases.jsonコマンドは、公式リリースをその都度確認します。インストールもデプロイも行いません。

PotbotとUnityについては、ネイティブホストの受け入れマトリックスに従ってください。データベース認証、制限付きアプリケーションID、パッケージ全体のインポート、実際のGPU読み戻し、保存済みシーンのスキニングには、それぞれ個別の証拠が必要です。

Unityプレビューのフォローアップには、リリース済みの0.5.0-preview.2の修正と、実際の合成GPU／リグの証拠を記録しています。実際のキャラクター、ソース楽曲、デプロイに関する制限も明示しています。

利用方法を選ぶ

Claude Codeにインストール · Codexにインストール · ローカルMCPサーバーを使う · コンポーネントを選ぶ · Arcadiansでツールを試す · 貢献する · 開発 · 自動リリースとレジストリーへの登録申請 · ビジュアル言語を理解する

Claude Codeにインストール

claude plugin marketplace add kieransimkin/DanceFlow
claude plugin install danceflow@danceflow

インストール後、セットアップスキルを実行してください。このツールキットにはコンポーネントごとのスキルが含まれています。また、選んだスキルをplugins/danceflow/skills/からクライアントがサポートするスキルディレクトリにコピーすることもできます。ポータブルなAgent Skills形式を使用しています。

Codexにインストール

codex plugin marketplace add kieransimkin/DanceFlow

プラグインディレクトリでDanceFlowを選択してインストールしてください。リポジトリーのマーケットプレイスでの配布と、ベンダーが選定した公開ディレクトリへの掲載は別のものです。ここでは、ベンダーによる承認や推奨を主張していません。

プラグイン承認とエージェント探索の計画では、公開ディレクトリへの掲載準備、キーワードを考慮した位置付け、ClaudeおよびMCP Registryでの利用経路、有用なインストールとツール選択の成果に関する継続的な調査を記録しています。 これはロードマップです。承認、公開、実測に基づく探索は、それぞれ別のマイルストーンです。

ローカルMCPサーバーを使う

バージョン 0.1.19 では、エコシステムハブと17コンポーネントの検出機能をパッケージ化し、Potbot と Unity のソースプレビューへの参照を含めています。配布メタデータ、コマンドラインのバージョン、MCP サーバーの ID の整合性を保ち、要求されたコンポーネントで最初に役立つ結果を得るためのセットアップを案内します。MCP の対応範囲、ランタイム設定、ジョブの完全ガイドをご覧ください。

vidIQ との比較と検出機能の即時改善案では、検証済みのプロバイダーパッケージングと、裏付けのない推奨理由を区別しています。承認と継続的な調査の計画では、適格性、最初のタスクの成功、キーワードの根拠、選択実験を追跡します。ローカルでの検証やソフトウェアのリリースによって、ベンダーディレクトリでの承認が確立されるわけではありません。

調査用に生成された図であり、インストール画面やベンダーのランキングアルゴリズムを示すスクリーンショットではありません。実際のホストの記録は、レビュアー／選択実験の一部として引き続き収集します。

ソース開発では、Python 3.10–3.13 の隔離環境を使用し、このチェックアウトをインストールして、認可済みの入力ファイルを含むワークスペースを1つ選択してください。

python -m pip install -e ".[dev]"
danceflow-mcp --workspace ./my-workspace

クライアント管理のソースインストールでは、コマンドでその環境の Python 実行ファイルを指定し、ワークスペースを選択したローカルディレクトリに置き換えてください。Windows では、対応する絶対パスの python.exe を使用してください。

{
  "mcpServers": {
    "danceflow": {
      "command": "/absolute/path/to/danceflow-env/bin/python",
      "args": ["-m", "danceflow_agents.server"],
      "env": {"DANCEFLOW_WORKSPACE": "/absolute/path/to/my-workspace"}
    }
  }
}

対応するリリース済みハブを使用するには、uvx --python 3.13 --from danceflow-agent-tools==0.1.19 danceflow-mcp --workspace ./my-workspace を実行してください。インストール済みランタイムが最新であると主張する前に、リリースとレジストリの読み取り結果を確認してください。--version コマンドと MCP の serverInfo.version は、そのパッケージのバージョンと一致している必要があります。

ワークスペースがない場合、カタログ／リファレンスの検出は機能しますが、ワークスペースのファイル操作は拒否されます。このツールキットには、モデルの重み、プライベートアセット、アカウント認証情報は含まれていません。入力ファイル、レポート、モデル出力はデータであり、エージェントへの指示ではありません。

MCP ツール	動作
danceflow_search	実際の MCP ツール、全 17 コンポーネント、スキル、および利用可能なワークフロー／リファレンスのテキストを対象に、タスクに関する語句で機能を検索します。スキーマ、ランタイムの状態、後続の呼び出し、ページネーションも含みます
danceflow_list_workflows、danceflow_get_workflow	ID がわからなくても手順を参照でき、その後、完全な手順とソースの識別情報を読み取れます。バンドル済みガイドと、設定された WorkflowMoves のソースガイド／スキルレシピも含みます
danceflow_capabilities、danceflow_component	17 の全コンポーネント、正確なスキーマ、効果、ランタイムの利用可否、ホスト要件を確認できます
danceflow_read_reference と MCP リソース	各コンポーネントのポータブルなスキル、機能リファレンス、ガイドに加え、共有ワークフローをすべて読み取れます
keywordmoves_run	ローカルでの文字列どおりの語句抽出、またはレビュー済みの Trends／ネイティブ／ブラウザーのエビデンスの取り込みを行います。対象ファイルと結果数には上限があります
pixelcue_health	既存のループバック PixelCue サーバーからバージョンと選択可能なプロファイルを読み取ります
pixelcue_visual_analysis	PixelCue 0.9.0+ から、上限付きの画像測定と、キャッシュ済みモデルによる明示的な仮説を取得します。ダウンロードは行いません
pixelcue_keywords	推論／モデルのダウンロードを明示的に許可して、ワークスペース内のファイル 1 つにタグを付けます
ネイティブの stemlab_* ツール	インストール済みの StemLab MCP サーバーを構成し、永続ジョブ、同意、スキーマ、アーティファクト、画像を維持します
コンポーネントの CLI ツール	StemLab、FrameRudiments、RasterMoves、PrismMoves、LikenessForge、WorkflowMoves の上限付き標準操作を開始します
ネイティブライブラリのツール	DanceRudiments のサンプリング、ThumbMoves キャッシュの読み取り、DanceMoves 入力の検証、タイムラインのクロック／歌詞の評価を行います
danceflow_job_status、danceflow_job_logs、danceflow_list_jobs、danceflow_cancel_job	エビデンスを保持したまま、自身が所有するバックグラウンドジョブを調査、管理します。自動再試行は行いません
danceflow_read_artifact、danceflow_check_releases	上限付きのローカルレポートページを読み取り、公式の安定版リリースを照会します

danceflow_search で render video、WordPress、thumbnail などの語句を検索するか、引数なしで danceflow_list_workflows を呼び出してください。コンポーネント名やリソース URI は必要ありません。各結果の next_call に従い、後続のページを読むには next_offset を使用します。検索では kind と component で絞り込めます。また、クエリが空の場合は一覧を参照できます。検索結果には対応範囲が明示されます。バンドル済みの DanceFlow ガイド 8 件は常に利用できますが、追加の WorkflowMoves ガイドとスキルレシピには、設定済みの source_root が必要です。任意のドキュメントが見つからない場合や読み取れない場合は、その旨が報告されます。検索で読み取るのはドキュメントとツール定義であり、手順の実行、パッケージのインストール、モデルのダウンロードは行いません。

ハブには、CLI アダプター 69 個とネイティブライブラリ操作 12 個を含むツールキットツール 97 個に加えて、インストール済みのネイティブ StemLab ツールが登録されます。各操作には JSON Schema があり、CLI の呼び出しは調査可能なバックグラウンドジョブを返します。任意のランタイムが不足していても、その状態は明示され、リファレンスの確認や他のツールの動作は妨げられません。MediaSlide、EPK Social Metadata、DanceVault は完全な統合リファレンスを公開しており、ドキュメントに記載されたブラウザーまたは WordPress のホストが必要です。

パッケージで別々の Python 環境を使用する場合、または WorkflowMoves で信頼できるチェックアウトが必要な場合は、--runtime-config または DANCEFLOW_RUNTIME_CONFIG に運用者が管理する JSON ファイルを指定します。ランタイムガイドでは、形式、モデルストアの制限、ワークスペースのパス、保護された WordPress バインディングについて説明しています。クライアントの入力で任意の実行ファイルやシェルコマンドを選択することはできません。ネイティブのプロジェクトファイルは信頼できる設定のままです。このアダプターは OS のサンドボックスではありません。 KeywordMoves の有料プロバイダー、ホスト型 LLM、ライブコレクターは、明示的に設定されたネイティブ操作として引き続き利用できます。PixelCue は Python 3.13 とともに別途インストールし、pixelcue-server を起動してください。モデル／ランタイムの要件は引き続き適用されます。StemLab のネイティブツールを連携させるには、選択したランタイムに StemLab の codex エクストラをインストールしてください。検出によってランタイムやモデルがインストールされることはありません。MCP HTTP テストでは合成サービスのフィクスチャを使用しており、特定の GPU／モデルが実行されたことを示すものではありません。

コンポーネントを選択する

ツール	用途
StemLab	音楽分析、ステム、タイミング、ハーモニー、歌詞、正確なループの根拠
DanceRudiments	決定論的なリズムパターンとネイティブ位置サンプリング
FrameRudiments	ネイティブモーションと保存済みの音楽的根拠からの、オフライン Shorts および歌詞ビジュアライザーのレンダリング
DanceMoves	Web クロック、エフェクト、入力、アクセシビリティ、ライフサイクル、適応型品質
KeywordMoves	ソース固有のキーワード検出と根拠のインポート
RasterMoves	ローカル画像のアップスケーリングと高画質化
LikenessForge	顔の類似性の修復、アイデンティティ LoRA のトレーニング、レビュー可能な比較シート
PixelCue	ローカルのビジュアルメディアのタグ付けとサービスワークフロー
PrismMoves	PixelCue の画像分析を活用したビジュアル言語プロファイルとレポート
ThumbMoves	明示的なキャッシュ未検出表示を備えた、キャッシュのみの OS サムネイル
React Timeline Sequence	オーディオタイムライン、トランスポート、サンプルフレームループ
EPK Social Metadata	WordPress の Open Graph、X カード、Schema.org
DanceVault	安定した暗号化 WordPress 配信。宛先ホストでの受け入れが必要です
WorkflowMoves	エコシステム全体に対応する、ガード付きルール、タスクガイド、スキル、追加型ルートのインストール
MediaSlide	リスト、詳細、サムネイル、スライド表示に対応した、レスポンシブな React メディア閲覧
Potbot	永続的なコーディングエージェントのタスク、根拠、モデルジョブ。ソースプレビュー、MCP クライアントは提供予定
DanceFlow for Unity	Unity 6 の音楽クロック、シェーダー、録音、プレビューリグ再生。ホストでの受け入れが必要です

オフライン動画には、FrameRudiments ワークフローを使用してください。レンダラーを別途インストールしてから、新しいプランファイル、個別のプリフライト／レンダリング出力ディレクトリ、保持されたレビュー用根拠を使用して、型付き MCP のプラン、プリフライト、レンダリングジョブを実行してください。

WorkflowMoves は、エコシステムで保守されているワークフローレイヤーです。ガード付きのルート変更をプレビューし、周辺のプロジェクト指示を保持するとともに、スイート全体を使用するためのユーザーおよびエージェント向けガイダンスを提供します。新しいワークフローを実行する前に、最新リリースを確認してください。プレビューに合格しても、宛先がルートを採用した証明にはなりません。

WorkflowMoves 0.1.34 向けの生成図です。実際のインストールと読み戻しには、別個の根拠が必要です。

画像の準備については、LikenessForge ワークフローとツールのオンボーディング手順を参照してください。LikenessForge は別途インストールします。制限付きの修復およびトレーニング MCP ジョブでは、モデル／ダウンロード／ネットワークとトレーニングに関する明示的な確認が保持され、生成されたアイデンティティの根拠を確認する必要があります。

メンバーであることは、すべての組み合わせが自動的に連携するという意味ではありません。Short Shifter は DanceFlow とはまったく無関係です。

Arcadians でツールを試す

動作するプレイグラウンドを開く · Hugging Face Space · ローカルで再現する

Kieran Simkin の Arcadians は、最初のサンプルトラックです。公開 MP3、変更されていないカバー、正規の歌詞、アーティストが設定したタイミングを使用しています。実際のタイムライン操作、ネイティブ WASM ムーブメントカタログ、メディアクロックのライフサイクルを試してみてください。StemLab が生成した波形と、KeywordMoves が生成して保存したフレーズの根拠を確認できます。すべてのサンプルには、そのソースと制限事項が記載されています。

コントリビューション

CONTRIBUTING.md と AGENTS.md をお読みください。範囲を絞った課題を選ぶか、再現可能な不備を報告し、正規のツールリポジトリを使用して、ドキュメントに記載されたチェックを実行したうえで PR を作成してください。メンテナーが変更をレビューし、検証後に対応するリリースを公開します。エージェントも、ほかのコントリビューターと同じ条件でこれらのツールを使用し、コントリビューションできます。

エージェントは利用可能な機能を調べ、適した場面では最大限に活用し、可能な限り有用な改善点を探してください。エンジンの改善は、上記にリンクされているツール独自のリポジトリに PR として提出してください。ツールキット、スキル、デモの改善は DanceFlow に提出してください。関連するテスト、ドキュメント、再現可能なサンプルを含めるか、価値ある改善が必要ない理由を説明してください。

開発

Windows での pytest 一時ディレクトリのアクセス許可

DanceFlow は、Windows で pytest の既定の一時フィクスチャを %LOCALAPPDATA%\DanceFlow\pytest\<checkout-fingerprint> に配置します。これにより、 古い %TEMP%\pytest-of-<username> のアクセス許可や同期フォルダーの名前変更ロックを回避しながら、 同時に作業するワークツリーを分離できます。明示的な --basetemp=PATH または PYTEST_DEBUG_TEMPROOT が指定されている場合は、そちらが優先されます。それ以外のプラットフォームでは、無視対象の .pytest-tmp/ をチェックアウト内の既定の場所として使用します。

python -m pip install -e ".[dev]"
python -m pytest
python scripts/validate_toolkit.py
python -m build
python -m twine check --strict dist/*.whl dist/*.tar.gz
python scripts/package_toolkit.py

ツールキットのコードとスキルは MIT ライセンスで提供されます。個々のコンポーネントにはそれぞれ独自のライセンスが適用され、サードパーティのモデルやデモアセットには個別の利用条件があります。

自動リリースとレジストリへの提出

タグ付きリリースでは、該当するチェックを実行し、設定されたレジストリへの提出に先立ち、対応する不変の GitHub パッケージを公開します。レジストリの手順と検証の制限では、自動化された conda-forge、ConanCenter、vcpkg への PR 提出ルートと、上流でのレビュー条件について説明しています。プロジェクトオーナー自身の PR は、必須のチェックに合格した後にマージされます。レジストリへの提出を受け入れるかどうかは、サードパーティのメンテナーが決定します。失敗または保留中の提出ルートは引き続き確認でき、リリース済みのバイト列を置き換えることなく再試行されます。

GitHub Pages は、既存の許可済み main ブランチ上のワークフローを通じて、タグ付きリリースの成功後にチェックサム検証済みのデモアセットをデプロイします。デプロイ前にタグ、パッケージのバージョン、ソースコミットを確認します。環境へのアクセスに関するポリシーは引き続き適用されます。

レジストリの初回レビューを維持する

レジストリのワークフローでは、ツールの新しい検証済みGitHub／PyPIバージョンが見つかると、各ツールについて最新の未完了のconda-forge初回レビューを再利用します。そのレビューのブランチ、コメント、依存関係やメンテナーによる編集は維持し、バージョン、ソースURL、チェックサム、ビルド番号のみを更新します。これにより、ツールが改善版をリリースするたびに、競合する初回レシピを新たに提出せずに済みます。既存のクローズ済みまたは承認済みの提出はステータスを維持し、マージするかどうかは引き続きアップストリームのメンテナーが判断します。承認済みのfeedstockは、独自の更新手順を使用します。

古い重複した初回PRは、現在の代替案がCIに合格した後、置き換え済みとしてクローズできます。レビュー履歴はGitHubで引き続き確認できます。 ウェブサイト：https://kieransimkin.co.uk/danceflow/.

FrameRudimentsは、歌詞やネイティブのアニメーションスプライトを含む、フレーム全体に適用するButterchurnおよび固定バージョンのprojectMエフェクトを提供します。セットアップとレンダリングを参照してください。

FrameRudiments 0.1.4の合成出力候補を、2つの実際のエンジンで処理する前と後に示しています。キャプションとネイティブの動くスプライト／アトラスは、同じエフェクト経路を共有します。 4秒のデモを再生し、トランスクリプトもご覧ください。

この図は説明用です。比較画像と動画は、レンダラーの実際の出力をキャプチャしたものです。projectMのポートレートマッピングでは、記録されたオーバースキャン／クロップによってジオメトリを維持します。処理後のテキストが読みやすいことと、出力先のセーフゾーンに収まっていることを確認してください。

ビジュアル言語を理解する

スタイルを展開する前に、画像を確認してください。PrismMoves は、PixelCue の色、テクスチャ、構図、選択したモデルのエビデンスを JSON、Markdown、HTML、計測済みの SVG サマリーにまとめます。アートワーク、キャンペーンビジュアル、参考資料に活用し、デザインを決める前に不明点をそのまま残してください。分析エンジンは PixelCue が担当し、プロファイルとレポートは PrismMoves が担当します。

PixelCue 0.9.0 による計測値を生成した図です。UI のスクリーンショットでも、意味的な正確さの評価でもありません。ビジュアル言語のワークフローを参照してください。PrismMoves は別途インストールします。CLI は PixelCue をプロセス内またはループバック HTTP 経由で呼び出します。MCP 分析ツールは、レポートファイルを作成せずに PixelCue のレシートを返します。600 秒のリクエストタイムアウトは、サーバー側の処理をキャンセルしません。

すべての DanceFlow モデルの重みとモデル固有のキャッシュは、所有するプロジェクトの models/ ディレクトリに置きます。models/ は .gitignore で無視し、配布物から除外してください。有用で、使用許可を得たモデルのみをインストールしてください。既存の重みを黙って移動したり、グローバルキャッシュにデータを追加したりしないでください。

FrameRudiments 0.3.0 では、上流のプリセット 14,680 件を重複なく固定し、3 種類の静的テストカード、サンプルの曲・カバー・タイミング付き歌詞の入力、無音コントロール、PrismMoves/PixelCue の応答比較を用いた、管理された間隔でのキャプチャが追加されました。キャプチャと合成のワークフローを読む。カタログに登録されていることと、個々のプリセットが実際に受け入れられることは別です。

生成したキャリブレーション用イラストです。再生可能な全フレームデモにはネイティブコントロールとトランスクリプトがあります。非公開の実験エビデンスとは別のものです。

Potbot、Unity、現在の機能範囲

使用前に、公式リリースと正確なランタイムを確認してください。Potbot と DanceFlow for Unity は、それぞれ独立して役立つソースプレビューですが、2026 年 10 月 23 日の監査時点で安定版リリースはありません。メンバーシップ、参照先の発見、パッケージのインストール、要件を満たした実行は、それぞれ別の状態です。

生成した契約図です。実線の矢印はファイル／API の責任を示し、破線の矢印は未実装の機能またはホスト側の受け入れを必要とします。この画像は、エンドツーエンドで実行できることを証明するものではありません。

共同ワークフローを利用し、このソースをインストールした後に python examples/ecosystem_discovery.py を実行してください。新しいエントリーでは、ソースに固定された参照先と、ネイティブホストに明示的に求められる要件を示します。Potbot MCP コンシューマーも Unity 実行アダプターも追加されません。StemLab のタイミング／単語編集、ネイティブリグのモーション、選択したチャンネルの歌詞試聴は、更新された機能一覧に掲載されています。