Puppetflow

Puppetflow

Puppetflow は、JavaScript ワークフローの作成、実行、スケジュール設定、監視を行うセルフホスト可能なブラウザー自動化プラットフォームです。ブラウザーセッションをリアルタイムで確認し、実行中に人の対応が必要になった場合はいつでも操作できます。

⭐️ Puppetflow が気に入ったら、リポジトリにスターを付けてください。プロジェクトをより多くの人に知ってもらう助けになります。

🌐 ウェブサイトとドキュメント

• ウェブサイト：puppetflow.com
• 動画：Puppetflow を100秒で紹介
• ドキュメント：docs.puppetflow.com
• セルフホストガイド：Puppetflow のインストールまたは更新

🎉 機能

• JavaScript でブラウザーワークフローを作成
• ワークフローを手動、スケジュール、またはインテグレーション経由で実行
• ブラウザーセッションをリアルタイムで確認し、必要に応じて操作
• ワークスペースでフローと再利用可能なスニペットを整理
• スコープ付きメディアライブラリでテキストファイルの保存、タグ付け、整理、編集を行い、フロー入力または $upload で再利用
• 変数、シークレット、ブラウザープロファイルを管理
• 実行履歴、ログ、実行結果を確認
• リポジトリや 1Password などの外部ボールトに接続
• メッセージングツールやメールボックスと連携
• Docker を使用して独自のインフラストラクチャにデプロイ
• 再利用可能なフローやスニペットで Puppetflow を拡張
• 認証済み REST API を使ってメディアライブラリのファイルやフォルダーを自動化

🔗 n8n 連携

Puppetflow は、n8n ワークフローにブラウザー自動化を追加するためのコミュニティノード n8n-nodes-puppetflow を提供します。

• 任意の JSON 入力を指定してフローをトリガーします。
• 実行を一覧表示して監視し、結果を取得します。
• スクリーンショット、ファイル、セッション録画をダウンロードします。

セルフホスト型 n8n インスタンスの Settings > Community Nodes からパッケージをインストールし、Puppetflow インスタンスの URL と Profile > API Keys で取得した API キーを使って接続してください。設定の詳細は、n8n 連携ガイドを参照してください。

🤖 AI クライアント向け MCP サーバー

すべての Puppetflow インスタンスは、Streamable HTTP 経由でリモートの Model Context Protocol サーバーを公開します。Cline、Cursor、Claude、Claude Code、その他の MCP クライアントを接続して、ブラウザー自動化フローの検索、確認、作成、実行、実行状況の追跡、および結果、スクリーンショット、録画の取得を行えます。

ローカルでは何も実行されません。Workspace > Settings > Instance MCP で MCP を有効にし、アクセストークンを作成してから、クライアントにエンドポイントを追加してください。

{
  "mcpServers": {
    "puppetflow": {
      "type": "streamableHttp",
      "url": "https://your-puppetflow.example/api/mcp-server/http",
      "headers": {
        "Authorization": "Bearer mcp_your_token_here"
      }
    }
  }
}

リモート MCP OAuth に対応したクライアントでは、PKCE と Dynamic Client Registration を備えた OAuth エンドポイントも利用できます。クライアントの設定手順については llms-install.md を、利用可能なすべてのツールについては MCP ガイドを参照してください。

Puppetflow の実際の動作

🛟 ディスカッション／お困りですか？

Discord に参加する

Issue を作成する

プロジェクトの理念

Puppetflow は、いくつかのシンプルな考え方を軸に構築されています。

• ブラウザー自動化は、理解しやすく、デバッグ可能な状態を保つべきです。
• セルフホストは、後付けではなく、実際に選べる選択肢であるべきです。
• 適切なデフォルト設定は重要ですが、ユーザーが自分のデータとインフラストラクチャを管理できるべきです。
• 中途半端な機能を数多くリリースすることより、信頼性と保守性を重視します。

プロジェクトの経緯について

Community Edition のリリースにあたり、セキュリティ上の理由から、公開されていた Git 履歴を意図的にリセットしました。そのため、このリポジトリのコミット数は、プロジェクトの歴史や成熟度を反映していません。

Puppetflow は、実際の環境でほぼ 1 年にわたり開発、運用されてきました。Community Edition は既存製品を公開したものであり、プロトタイプの始まりではありません。

AI 生成物に関する方針

Puppetflow は、労力をかけずに生成され、レビューされていないコードやコンテンツを受け入れません。

AI を活用した作業を禁止しているわけではありません。投稿者が理解していない、確認していない、または保守できない生成物の提出を禁止しています。貢献は意図を持って行い、既存のコードベースとの一貫性を保ち、提出者自身が責任を持つ必要があります。

具体的なルールについては、貢献ガイドをご覧ください。

リポジトリのドキュメント

• セルフホストインスタンスをインストールまたは更新する
• 開発環境をセットアップして貢献する
• ソースコード公開ライセンス
• プロプライエタリ機能のライセンス

ライセンス

Puppetflow はソースコード公開です。コードの大部分はPuppetflow ソースコード公開ライセンスの下でライセンスされており、個人による非商用利用が認められています。社内業務での利用には、有効な Puppetflow の有料サブスクリプションまたは注文が必要です。

proprietary/ 配下のファイル、.pp. マーカーを含むファイル、および明示的にマークされたコードブロックは、有料機能を実装しています。これらはPuppetflow プロプライエタリライセンスの対象であり、本番環境で使用するには有効な Puppetflow サブスクリプションが必要です。