UGT: Use the GitHub Thing

GitHubで見つけたら、使ってみましょう。

使いたいプロジェクトのGitHubリンクを貼り付けてください。
UGTがコンピューターで使えるようにし、次回の使い方も案内します。
無料のオープンソースです。Windows、Mac、Linuxに対応しています。

仕組み · はじめに · できること · エージェントに聞くだけではだめなのですか？ · カタログ · レシピを共有する · 利用ルール

仕組み

1. GitHubリンクから始めます。 遭遇したエラーや、プロジェクトでやりたいことを追加することもできます。
2. お使いのコンピューターに合わせたセットアップ手順に従います。 UGTは、すぐに使えるセットアップやプロジェクト独自のインストーラーを探します。さらに詳しく調べる必要がある場合は、AIアプリが同じリンクと詳細情報を使って続行します。レシピとは、誰かがすでに確認したセットアップ手順です。プロジェクトにレシピがない場合は、エージェントが作成できます。
3. 作成されたものを使います。 できあがったファイルまたはアプリを開きます。ファイルを扱う処理では出力を確認し、アプリは終了して再び開いても保存データを保持します。実行に失敗した場合は、最初から会話をやり直さず、その実行についてサポートを求めることができます。
4. よければ共有してください。 正常に動作したら、UGTからレシピをカタログに投稿できます。次の人はすぐに使えるようになります。

はじめに

GitHub プロジェクトを UGT に貼り付けてください。リンクだけで十分です。すでにインストールを試している場合は、表示されたエラーも含めてください。

まず UGT をセットアップするには、UGT を入手して AI アプリを接続してください。

UGT は、そのプロジェクトをお使いのコンピューターで利用する方法を確認します。UGT で開くが表示されたら、それを開き、必要であればファイルを選択して実行してください。ファイルの準備ができると、UGT にそのフォルダーが表示されます。アプリはそれぞれのアドレスで開きます。

プロジェクトをさらに詳しく確認する必要がある場合は、デスクトップ AI アプリで続けてください。ウェブサイトから、リンクとメモがプロジェクトのメッセージに引き継がれます。UGT のインストールが必要な場合は、セットアップ方法が表示されます。UGT にサブスクリプションはありませんが、AI アプリ独自の利用制限と料金は適用されます。

初めてお使いですか？プロジェクトページでAI アプリでセットアップを選択してください。アプリの接続中も、再起動後も、プロジェクト、選択したタスク、メモは保存されます。エージェントは続行する前に、ローカルの UGT 接続を確認します。VS Code をお使いの場合は、Agent モードで Copilot Chat を開き、ツールピッカーで UGT を有効にしてください。

GitHubは世界最大の無料ソフトウェアの宝庫ですが、その多くはアプリではなくコードとして公開されているため、本来役立つはずの人たちに届いていません。UGTを使えば、そのどれでも、頼むだけで使えるものにできます。

_{注目の例をいくつか紹介しています。カタログのレシピを使う必要はありません。レシピがなくても、エージェントが初回にプロジェクトの動かし方を解明します。レシピがあれば、誰かがすでに解決しているため、より速く実行できます。}

エージェントに頼むだけではだめなのですか？

エージェントはコードを読めますが、通常はそれを実行できず、毎回ゼロから作業を始めます。

• GitHubの大半はLinuxを前提としています。 WindowsやMacでは、エージェントは行き詰まってしまいます。UGTはLinuxでも、1ステップでセットアップできる専用のLinuxエンジンを用意しています。Docker Desktopもアカウントも、覚えることも必要ありません。Intel Macでは、すでにお使いのエンジンを動かします。
• 一度実証すれば、あとは誰でもすぐに使えます。 プロジェクトを動かせるようにするため、最初のエージェントはメモリ制限、アーキテクチャの違うバイナリ、足りないシステムライブラリ、インターネットに接続できないリゾルバーなどの問題に対処しながら、1時間かけて構築や修正をすることがあります。そのエージェントが残したレシピがあれば、次の人はダウンロードするだけで実行できます。
• 「起動しました」ではなく、成果を検証します。 コンテナーが起動しただけでは、作業が完了したとは言えません。すべてのレシピには、実際に成果が得られない場合に失敗する検証手順が含まれます。録音に合った字幕、指定した長さの動画、実際にプリントできるメッシュなどを確認します。
• あなたのマシンで、あなたのファイルを使います。 プロジェクトは、レシピで宣言されたファイルとアクセス権だけを使えるサンドボックス内で実行されます。カタログでは、レシピを登録する前にそのアクセス権を審査します。ローカルで作成したレシピが通常のサンドボックスの範囲を超える場合、UGTは事前に確認します。クラウドコンピューティングには、あなたの同意と明示された費用が必要です。

カタログ

レシピは近道であり、必須ではありません。 それぞれ、誰かがすでにある作業をするために使えるようにしたプロジェクトで、ほかの人が一から試行錯誤しなくて済むよう共有されています。レシピは誰でも読める recipes/ 内のフォルダーで、実行するものをすべてまとめた compose.yaml と、その内容を説明する recipe.json が入っています。1つのプロジェクトに複数のレシピを用意でき、作業ごとに1つずつ使えます。

usegeekthing.com/recipes で閲覧するか、recipes/ でソースを確認してください。すべてのレシピは登録前にクリーンなマシンで検証され、新しいレシピは登録されると同時に、UGT を更新しなくても誰でも使えるようになります。

_{検証済みとは、すべてのサービスがクリーンな amd64 および arm64 マシンで記述どおりに実行され、2つのチェックに合格し、さらに両方のチェックが意図的に壊した出力を拒否したことを意味します。注目のレシピのイメージは検証済みのものです。ほかのレシピは、同じ固定されたコミットとベースから、お使いのマシン上でビルドされます。}

recipes/openai/whisper/subtitles/
  compose.yaml    everything that runs: build, limits, mounts, network, and the four services
  recipe.json     what it is: project, commit, task, settings, the access it needs, licence
  Dockerfile      fetches the pinned source itself, so the build needs no clone
  check/          the check scripts

レシピを共有する

役立つ作業をするプロジェクトをお持ちですか？ 次の人が一から試行錯誤せず、すぐに使えるよう共有しましょう。

AI に 「Use the Geek Thing: share this recipe」 と伝えるか、ugt recipe submit を実行してください。UGT は最初からもう一度実行できることを確認し、個人情報（ファイル、パス、キー）が含まれないようにして、あなたの名前でプルリクエストを作成します。その後、シークレットを使えないクリーンなマシンで検証され、合格すると登録されます。サンドボックスの範囲を超えるレシピは、まずメンテナーがレビューします。

_{UGT アプリとともに提供予定です。 それまではソースから：}

go install github.com/usegeekthing/ugt/cmd/ugt@latest
ugt recipe new <owner>/<repo> <task>     # start one, or adopt the project's own Compose file
ugt recipe verify <folder>               # until it passes
ugt login                                # once: approve a code in your browser
ugt recipe submit <folder>               # opens the pull request as you

ugt recipe submit --dry-run を実行すると、送信される内容を事前に正確に確認できます。詳細は CONTRIBUTING.md とカタログのルールをご覧ください。

プロジェクトをメンテナンスしていますか？ 「Run with UGT」バッジを準備中です。README に追加すると、ワンクリックでプロジェクトを UGT で開けるようになります。

基本ルール

• ファイルはあなたのものです。 入力はコピーされます。レシピに理由が記載され、メンテナーがレビューした場合、またはあなたが同意した場合を除き、ホームフォルダー、キー、コンテナエンジンがプロジェクトに渡されることはありません。
• 何でも実行できますが、隠しごとはありません。 レシピはインターネット、フォルダー、デバイスなどを必要とする場合があります。それぞれを明示し、UGT は宣言されていないものを拒否します。カタログへの登録前にメンテナーがレビューします。ほかの場所から入手したレシピは、お使いのコンピューターに届く前に確認を求めます。
• 証拠がなければ、実行されていないのと同じです。 チェックがなければ、成功とはみなされません。
• 決めるのはあなたです。 インストール、管理者権限の確認、大容量ダウンロード、アカウント、キー、クラウドコンピューティングは、常にあなたが選択できます。実行前に明確に確認します。
• シークレットがエージェントを経由することはありません。 UGT が一度だけ直接入力を求め、シークレットはシステムのキーチェーンに保存されます。
• クレジットはコードとともに引き継がれます。 各レシピにはプロジェクトのライセンスが記録され、上流から改変したファイルには元のライセンスが維持されます。
• ファイルがコンピューターの外に出ることはありません。 UGT はカタログにプロジェクトが利用できるレシピを問い合わせ、レシピに必要なものをダウンロードします。実行レポートは同意した場合にのみ送信されます。そこに含まれるのは、実行したレシピとその結果だけで、ファイル、パス、出力は含まれません。詳しくはプライバシーポリシーをご覧ください。

ライセンス

Apache-2.0。パッケージ化された各プロジェクトは、それぞれ独自のライセンスを保持しています。UGT の名称とロゴはライセンス対象ではありません。NOTICEをご覧ください。UGT は独立しており、GitHub とは提携していません。セキュリティ上の問題はSECURITY.mdまでご連絡ください。

_{auscasterによって作成}