本文へスキップ
AI@https://hoody.com Connect to Hoody

開発者モード

飾らずに書きました。Hoodyの中身を具体的に示します。

各セクションに、Hoodyの実体であるリンク、呼び出し、上限を表示しています。すべての部品はホームページの一覧にまとまっています。AIはこれらを組み合わせ、ほかにも多くのことをこなします。

索引を開く

hoody / computers + kit

コンピューター + Kit

オンラインのフルLinuxコンピューター。
中のツールには、それぞれリンクがあります。

Hoodyのコンピューターは、フルLinuxマシンです。Debian 13、systemd、専用のファイル、ネットワーク、プロセスがあります。アプリを動かし、中でDockerを実行できます。Hoody Kitを使うと、ターミナル、デスクトップ、ブラウザー、エディター、ファイル、データベースを、それぞれのHTTPSリンクで開けます。自分でも、チームでも、AIでも使えます。

インストールは不要です。リンクを開けば、ノートパソコン、スマートフォン、テレビでツールが使えます。

表示例です。下のリンクを開くと、ブラウザーでツールそのものが開きます。別のツールを選ぶと、同じタブにそのツールが表示されます。

ツールごとに1つのリンク

ツールを選ぶと、リンクが切り替わります

https://p7-c2-terminal-1.n12.computers.hoody.com

p7プロジェクトc2コンピューターterminalツール1インスタンスn12サーバー

+7
terminal-1ブラウザーで使えるフルLinuxシェル。URLのツール名の部分を入れ替えると、同じコンピューターのほかのツールに届きます。1を2に変えると、同じファイルを共有する2つ目のセッションになります。Kitで見る ↓

開発者向け

リンクの形式
https://{p}-{c}-{tool}-{n}.{node}.computers.hoody.comプロジェクトID、コンピューターID、ツール、インスタンス、サーバー。各部分は個別に読み取りも差し替えもできますdocs / foundation / projects-computers
動かすポート
https://{p}-{c}-http-8080.{node}.computers.hoody.comポート8080で動くサイトやアプリ。HTTPS込み
コンピューターの一覧
hoody computers list列:ID NAME STATUS IMAGE CREATED
リンクを調べる
GET https://api.hoody.com/api/v1/computers/{id}リンクの各部分となるproject_id、id、server_nameを返します
hoody / computers

サーバー、コンピューター、Kit

複数の国にサーバー。
どのサーバーにもコンピューター。
どのコンピューターにもKit。

サーバー4台の例です。Freeプランのサーバーは、希望するリージョンを指定できますが、空き状況によります。Plusプランのサーバーは米国東部、Proプランのサーバーはフィンランド、Bare metalプランのサーバーはシンガポールで動きます。各サーバーには複数のコンピューターがあります。各コンピューターには、Kitのツールが入っています。
サーバーが動く場所8リージョン
  • US米国西部
  • CAカナダ
  • US米国東部
  • FRフランス
  • DEドイツ
  • FIフィンランド
  • INムンバイ
  • SGシンガポール

Freeのサーバー:リージョンの希望は空き状況によります

次のサーバー:リージョンを選べます

  1. 1Free

    リージョン希望は空き状況によります

    共有マシンの一部

    3台のコンピューター

  2. 2Plus

    リージョン米国東部

    共有マシンの一部(有料ユーザーのみ)

    コンピューター12台

  3. 3Pro

    リージョンフィンランド

    共有マシンの一部(有料ユーザーのみ)

    コンピューター30台

  4. 4Bare metal

    リージョンシンガポール

    マシン1台を丸ごと専有

    空きがある分だけ

コンピューター1台の中身どのコンピューターにも入っています

Kit

  • ターミナル
  • デスクトップ
  • コード
  • ファイル
  • SQLite
  • ブラウザー
  • ほか
  • コンテナーすべてのサーバー
  • 仮想マシンBare metalのみ
サーバー
まずはFreeのサーバー1台から始めます。有料プランには、それぞれサーバーが1台ずつ加わり、リージョンを選べます。サーバーは、共有マシンの一部か、マシン1台を丸ごと専有するものです。
コンピューター
各コンピューターは、動き続けてファイルも残る、フル機能のLinuxマシンです。独自のコンテナーを動かせ、Bare metalでは仮想マシンも動かせます。
Kit
Hoody Kitは、リンクで開けるツールを各コンピューターに用意します。コンピューターの起動直後から使えます。

各コンピューターの中

Debian 13 · systemdサービス · 専用のファイル、ネットワーク、プロセス · 状態を保持

01 / 中で作業する

  • エージェントファイルと同じ場所でAIを使えます。ブラウザーまたはSSHからアクセスできます。
  • ターミナルブラウザーのタブで使えるシェル。リンクで共有できます。
  • デスクトップブラウザーでLinuxアプリを使えます。テレビでも。
  • コードブラウザーのタブで使えるVS Code。

02 / 構築と実行

  • Execスクリプトファイル内の関数が、稼働中のエンドポイントになります。
  • デーモンサーバーやワーカーを動かし続けます。
  • Cronスケジュールしたジョブ。終了日も設定できます。

03 / データとWeb

  • ファイル自分のファイルに加え、Drive、Dropbox、S3などを扱えます。
  • SQLiteサーバーを動かす必要のないデータベース。
  • ブラウザーAIが操作できるChromiumまたはFirefox。すべてのツールとリンク ↓

04 / リンクがアプリに届くまで

すべてのリンクは、コンピューターと同じサーバー上のHoodyプロキシを通ります。HTTPSを付け、アクセスできる相手を確認し、リクエストを中のツールやアプリに渡します。

https://p7-c2-
http-3000

http-3000は、コンピューター内のポート3000で待ち受けるアプリです。数字を変えると別のアプリに届きます。例:http-5000、http-8000。

外からは常にポート443のHTTPSです。プロキシが各アクセスをアプリのポートに渡します。

docs / proxy ↗
.n12.computers.hoody.com
Hoodyプロキシ

コンピューターと同じサーバー上で動くため、中継が増えず、通信はそのサーバー内にとどまります。証明書の発行と更新は自動です。

HTTP/1.1、HTTP/2、WebSocketに対応します(動作中のターミナルやデスクトップが使います)。サーバーが対応していれば、HTTP/3も使えます。

docs / concepts / proxy ↗
訪問者の実際のIP

Hoodyプロキシが直接中継する外部からのリクエストでは、間にプロキシがないかのように、訪問者の実際のIPアドレスがアプリに見えます。X-Forwarded-Forヘッダーを読む必要はありません。

サーバーのカーネルで処理されるため、古いソフトウェアを含むどのプログラムでも、訪問者をログに残し、レート制限し、ブロックできます。設定は不要です。プロキシフックが転送したリクエストでは、代わりにフックの接続元アドレスが表示されます。Hoodyのコンピューターからの呼び出しでは、別の接続元アドレスが表示されることがあります。

docs / concepts / proxy ↗
アクセスできる人

どのリンクも、パスワード、ログイン用トークン、許可IPアドレスのリストでロックできます。プロジェクト全体にも、コンピューター1台にも設定できます。

docs / proxy / permissions ↗
プロキシフック

自分のスクリプトが、各リクエストを最初に受け取ります。確認、変更、応答、次への受け渡しのどれもできます。スクリプトは自分のExecで動き、ほかのユーザーのExecとは分離されています。

docs / proxy / hooks ↗
独自の名前

ツールやアプリに、my-api.n12.computers.hoody.comのような短い名前を付けられます。所有するドメインを向けることもできます。証明書の発行と更新は自動です。

docs / proxy / your domain ↗
ローカルトンネル

ノートパソコンで動くアプリを、コンピューターの公開リンクに表示できます。逆に、コンピューターからノートパソコンのサービスに接続することもできます。

ノートパソコンから外向きに接続するため、受信接続は受け付けません。DNS、証明書、登録の手順もありません。

docs / kit / tunnel ↗
外向き通信

上のプロキシとは別の、逆方向の通信です。コンピューターが送るリクエストは、選んだ上流のSOCKS5またはHTTPプロキシ経由で出ていけます。送信元のIPを変えられます。

docs / kit / egress ↗

中で動かせるもの

Docker、Kubernetes

Docker、Compose、Buildxは、開発キットにそろっています。開発キットは初期状態でオンです。Kind、K3s、Minikubeで完全なKubernetesクラスターを動かせます。Podmanも使えます。

すべてのサーバーで使えます。

docs / computers / images ↗
仮想マシン

KVMをオンにすると、コンピューターの中で別のOSやカーネルを起動できます。

Bare metalでサーバーを丸ごと借りた場合のみ使えます。初期状態ではオフです。Freeプランでは使えません。

docs / servers / virtual machines ↗
コンピューターの追加

コンピューターごとの料金はありません。サーバーのプランと空き容量の範囲で作成できます。一度の呼び出しで、別のサーバーやプロジェクトにコピーもできます。

Freeプランには3台のコンピューターが含まれます。

docs / servers ↗

すべてのサーバーBare metalのみ

開発者向け

ポート3000のアプリ
https://{p}-{c}-http-3000.{node}.computers.hoody.comhttp-{port}は、そのポートのアプリに届きます。外からはポート443のHTTPSですdocs / foundation / proxy
訪問者の実際のIP
req.socket.remoteAddressNodeでは訪問者のIP。Execスクリプトではmetadata.clientIpdocs / concepts / proxy
コマンドを実行
POST https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/executebody {"command": "docker ps", "wait": true}docs / kit / terminals
KVMをオンにする
PUT https://api.hoody.com/api/v1/computers/{id}/kvmbody {"kvm": true}(コンピューターを停止した状態で、専用サーバーのみ)docs / foundation / servers / virtual-machines
hoody / managed

作業を支える土台

下から上まで、Hoodyが運用

Hoodyがインフラを運用し、作業を動かし続けるためのツールを提供します。サーバーの管理に追われず、サイト、アプリ、ワークフローを作れます。

01 / サーバー

Bare metalの運用は、
Hoodyが担う。

OVHcloudとHetznerのBare metalを、Hoodyがすべて運用します。セキュリティ更新とカーネル更新もHoodyが行います。プロバイダーのアカウントやサーバーの設定は不要です。

Explore the infrastructure ↗
構築する場所フルLinuxコンピューター

Debian 13、rootアクセス、保持されるストレージ。DockerとComposeがすぐに使えます。

docs / computers / images ↗

02 / 上で動くコンピューター

クラッシュしたアプリは再起動します。
サーバーとワーカーを、自動再起動ポリシー付きのデーモンとして実行します。docs / kit / daemons ↗
保存バージョンを作成して、そこに戻せます。
変更の前にスナップショットを作成し、保存したディスクの状態を復元します。実行中のプロセスとメモリは、まっさらな状態から始まります。docs / computers / snapshots ↗
タブを閉じても、作業は動き続けます。
コンピューターは起動したままです。ファイル、設定、データベースは、離れても残ります。
サービスは接続済みです。
KitはHTTPSのリンクで開けます。アプリにもリンクが付き、証明書はHoodyが扱います。
hoody / inside your computers

コンピューターの中

Kitが付属します。

ターミナル・ファイル・ブラウザー・データ・AIが、最初からコンピューターの中にあります。サービスはそれぞれのリンクで開きます。どれも同じ権限モデルで使えます。

例を見るを選ぶと、例が表示されます。
どのリンクもAPIです。
AIも使えます。

{p} プロジェクト ·{c} コンピューター ·{node} サーバープレースホルダーIDを使ったリンクの形

ターミナル

コマンドを実行し、保持されるシェルセッションを共有します。

https://{p}-{c}-terminal-1.{node}.computers.hoody.com
POST /api/v1/terminal/execute

ディスプレイ

Linuxアプリをブラウザーで開きます。

https://{p}-{c}-display-1.{node}.computers.hoody.com
GET /api/v1/display/screenshot

ブラウザー

HTTPでChromiumまたはFirefoxを操作します。

https://{p}-{c}-browser-1.{node}.computers.hoody.com
GET /api/v1/browser/snapshot

コード

VS Codeをブラウザーのタブで使います。

https://{p}-{c}-code-1.{node}.computers.hoody.com
https://{p}-{c}-code-1.{node}.computers.hoody.com/?folder=<path>

ファイル

ファイルをリンクから閲覧、編集、ダウンロードできます。

https://{p}-{c}-files-1.{node}.computers.hoody.com
GET /api/v1/files/{path}

SQLite

HTTPでSQLデータベースやキーバリューデータにクエリを実行します。

https://{p}-{c}-sqlite-1.{node}.computers.hoody.com
POST /api/v1/sqlite/db

Exec

JavaScriptまたはTypeScriptのファイルをHTTPエンドポイントにします。

https://{p}-{c}-exec-1.{node}.computers.hoody.com/{script}
GET /{script}

エージェント

Web、SSH、CLIから同じAIセッションを使えます。

https://{p}-{c}-agent-1.{node}.computers.hoody.com
hoody agent prompt "<task>" -c <id>

Curl

HTTPリクエストを、共有やスケジュール実行ができるリンクにします。

https://{p}-{c}-curl-1.{node}.computers.hoody.com
POST /api/v1/curl/request

デーモン

サーバーやワーカーを動かし続けます。自動で再起動します。

https://{p}-{c}-daemon-1.{node}.computers.hoody.com
POST /api/v1/daemon/programs/add

Cron

コマンドをスケジュール実行します。ジョブに有効期限も設定できます。

https://{p}-{c}-cron-1.{node}.computers.hoody.com
POST /api/v1/cron/users/{user}/entries

通知

デスクトップ通知を送るか、開いているブラウザーのページに中継します。

https://{p}-{c}-n-1.{node}.computers.hoody.com
POST /api/v1/notifications/notify

パイプ

名前付きリンクを通して、デバイス間でバイト列をストリーミングします。

https://{p}-{c}-pipe-1.{node}.computers.hoody.com/api/v1/pipe/{name}
PUT /api/v1/pipe/{name} · GET to receive

外向き通信

コンピューターをプロキシとして使うか、上流プロキシを設定します。

https://{p}-{c}-egress-1.{node}.computers.hoody.com
GET /api/v1/egress/upstream

トンネル

ローカルのWebアプリを公開するか、ローカルのTCPサービスに接続します。

https://{p}-{c}-tunnel-1.{node}.computers.hoody.com
https://{p}-{c}-http-{port}.{node}.computers.hoody.com

プログラム制限

デーモンを制限します。読み取り専用のファイル、ポートとプロセスの制限、専用のファイアウォールを設定します。

https://{p}-{c}-daemon-1.{node}.computers.hoody.com
POST /api/v1/daemon/programs/edit/{id}

ほとんどのサービスは、最初に開いたときに起動します。プログラム制限はデーモンの機能です。ほかに、ノート、Watch、Run、プロキシログが含まれます。

docs / kit
hoody / do it directly

アイデアからリクエストまで

直接実行する3つの方法。

同じ操作を、HTTPで、ターミナルから、またはTypeScriptで実行します。必要なことを伝えれば、AIが呼び出しを行います。

コンピューターでコマンドを実行し、出力と終了コードを受け取ります。

HTTPリクエスト / ターミナル
POST https://{p}-{c}-terminal-1.{node}.computers.hoody.com/api/v1/terminal/execute
Content-Type: application/json

{
  "command": "ls -la /app",
  "wait": true
}

ターミナル1で実行します。レスポンスにコマンドの出力が含まれます。

docs / kit / terminals ↗
この例を使う前に

{p}、{c}、{node}を、プロジェクトID、コンピューターID、サーバー名に置き換えてください。Kitのリクエストには、設定したプロキシの認証情報が使われます。

Account API requests use Authorization: Bearer <token>.
Service requests use your link's proxy permissions.
docs / proxy / permissions ↗

AIに頼むこともできます

Hoodyのコンピューターでls -la /appを実行し、出力を見せてください。

Hoody AI(無料)が組み込まれています。ChatGPTのプラン(Codexでログイン)や、Claude ProまたはMaxも使えます。Give your AI the Hoody Skill ↗

無料で始める、1行で。

カード不要で、無料で始められます。Hoody AIは組み込み済みで、すでに使っているAIも使えます。

コード不要
コード
AI@https://hoody.com Connect to Hoody

ChatGPT、Claude、ページを取得できるAIで使えます。コピーして貼り付けます。

AI
@https://hoody.com Connect to Hoody
docs / foundation / agent-skill-bundle
ブラウザー
https://hub.hoody.com
docs / kit / agent
ターミナル
ssh hoody.comSSHクライアントがあるマシンなら、対話型のターミナルで使えます。インストールは不要です。
docs / kit / agent
スキル
npx skills add https://hoody.com/SKILLS/SKILL.mdnpx skills add HoodyNetwork/hoody-sdk2つ目は、すべてのドキュメントページをディスクに追加し、オフラインで使えるようにします。
docs / foundation / agent-skill-bundle
CLI
npm install -g hoody-sdkcurl -fsSL https://install.hoody.com | sh2つ目はLinuxとmacOS用です。インストールせずに使う場合:npx hoody-sdk <command>
docs / foundation / cli
SDK
npm install hoody-sdkTypeScript用。Node.js 20.19以降、Bun、Denoで使えます。
docs / getting-started / quickstart
HTTP API
curl -H "Authorization: Bearer <token>" https://api.hoody.com/api/v1/computers/
docs / api / authentication
ブラウザーSDK
<script src="https://cdn.jsdelivr.net/npm/hoody-sdk/dist/hoody-sdk.browser.min.js"></script>window.HoodySDKを使えるようにします。本番ではバージョンを固定し、ページには有効期間の短い、範囲を限定したトークンを渡してください。
docs / getting-started / quickstart

2021年から

プライバシーからエージェント向けインフラへ

hoody / kit

コンピューターに付属するもの

サービスにはそれぞれ専用のリンクがあります。開いたり、共有したり、AIに渡したりできます。リンクを知っている人は誰でも、ロックするまで開けます。Kitのリンクの形式はhttps://{p}-{c}-<kit>-1.{node}.computers.hoody.comです。{p}はプロジェクト、{c}はコンピューター1台、{node}はそのサーバーです。

コンピューター

Bots

API