Oya Browser

規制対象業界向けのブラウザー（コミュニティ版）。

人々とAIエージェントが、実行場所や管理方法を制御しながら、1つのブラウザーで協力して作業できます。

Oya Browser をダウンロード · クラウドで使い始める · Oya をセルフホストする · エンタープライズについては、[email protected] までお問い合わせください

_{Oya デスクトップアプリでの実行を早送りしたものです。ポータルと患者データは架空のものです。実行 1 · 実行 2 · 実行 3をご覧ください。}

このリポジトリには、Oya Browser コミュニティ版が含まれています。人々とAIエージェントが1つのブラウザーで協力して作業できます。エージェントは、既存のログイン済みブラウザーを利用したり、管理されたクラウドブラウザーを起動したり、使い慣れたツールやAPIを通じて接続したりできます。人々は作業を確認し、必要に応じて介入し、ブラウザーへのアクセスと繰り返し実行できるタスクを管理できます。

HIPAA対応版を含むエンタープライズ版は、別のプライベートリポジトリで管理されています。このエディションについては、[email protected] までお問い合わせください。

始め方を選ぶ

AI アシスタントで Oya を使う

デスクトップアプリをインストールしてサインインし、アプリからアシスタントに接続します。Oya は Claude Code、Codex、Cursor、VS Code に対応しています。エージェントのブラウザー操作を確認し、タスクで注意が必要なときに操作を引き継げます。

デスクトップアプリをダウンロード · エージェント設定ガイド

Node.js からブラウザーを操作する

SDK をインストールし、oyabrowser.com でAPIキーを作成します。Node.js 20 以降が必要です。

npm install @oya-ai/browser

OYA_API_KEY を設定してから、次を実行します。

import { Oya } from '@oya-ai/browser';

const oya = new Oya();
const browser = await oya.browser.start();

try {
  await browser.goto('https://news.ycombinator.com');
  console.log(await browser.ask('Summarize the top three stories.'));
} finally {
  await browser.stop();
}

ブラウザープロバイダーを設定していない場合、start() はアカウントにすでに接続されている Oya デスクトップブラウザーを利用できます。クラウドブラウザーまたはセルフホスト型ブラウザーを起動するには、npx @oya-ai/cli init でプロバイダーを設定してください。SDK と CLI は、Browserbase、Steel、Anchor、Browser Use、または独自に用意したブラウザーも利用できます。プロバイダーを変更しても、アプリケーションでは同じ SDK 呼び出しを使い続けられます。

SDK ガイド · 実行可能なサンプル · CLI ガイド

MCP 経由で接続する

リモート MCP に対応したアシスタントの場合は、https://oyabrowser.com/mcp/pool に接続し、Oya APIキーで認証します。Claude Code の場合：

claude mcp add --transport http oya https://oyabrowser.com/mcp/pool \
  --header "Authorization: Bearer $OYA_API_KEY"

独自のデプロイを実行する場合は、セルフホストサーバーのURLを使用して、同じエンドポイントに接続してください。

エージェント向け手順と MCP リファレンス

AI エージェント向け

セットアップ手順、利用可能なツール、SDK のサンプル、MCP の設定については、エージェント向けリファレンスをご覧ください。デスクトップアプリは Claude Code、Codex、Cursor、VS Code とペアリングできます。リモート MCP クライアントからは、Oya API キーを使って https://oyabrowser.com/mcp/pool に接続してください。

独自の環境で Oya を実行する

インストーラーを使ってセルフホスト可能なインスタンスをセットアップします。

curl -fsSL https://raw.githubusercontent.com/OyadotAI/oya-browser/main/install.sh | sh

本番環境では、Docker、Amazon ECS、Kubernetes、または GKE を選択してください。デプロイガイドでは、設定、ストレージ、アップグレード、運用について説明しています。

セルフホストガイド · デプロイテンプレート

Oya でできること

• サインイン済みのブラウザーで作業できます。 デスクトップアプリを接続し、Chrome、Arc、Brave、Edge、Firefox からインポートしたログイン情報を再利用できます。ログイン情報を設定する。
• 人が制御できる状態を保てます。 エージェントの作業を見守り、AI Mode と Human Mode を切り替え、エージェントの操作を専用のタブに保てます。
• 成功した実行をプレイブックにできます。 再利用可能なタスクを新しい入力で再実行し、生成された Playwright モジュールを確認して、ワークフローをエクスポートまたはインポートできます。 プレイブックの詳細 · 再実行ベンチマーク。
• ブラウザーの実行場所を選択できます。 Oya Cloud、独自のデプロイ環境、サポート対象のブラウザープロバイダー、または自分で用意したブラウザーを使えます。Oya 経由でルーティングする理由。
• ガバナンス制御を適用して運用できます。 セルフホスト可能なコミュニティデプロイメントには、ホストの送信トラフィックルールと改ざんを検知できる監査証跡が含まれます。制御の証跡とトラストセンターをご覧ください。

コントリビューター向け

Oya はブラウザー、コントロールプレーン、コンソール、SDK、CLI で構成されています。まずアーキテクチャマップを確認し、変更する予定の領域のガイドをお読みください。

• アーキテクチャの概要
• 開発環境のセットアップとコマンド
• 未解決の課題
• Discord でコミュニティに参加

開発

要件とコマンドはプロジェクト領域によって異なります。規約とコマンドの全一覧については、このリポジトリでの作業をご覧ください。ワークスペース全体の依存関係をインストールするには、次のコマンドを実行します。

npm run setup

一般的なチェック：

npm run lint
npm run format:check
npm test

テストコマンド全体を実行すると、SDK をビルドし、サーバー、CLI、パッケージ、スクリプトの各テストスイートが実行されます。UI またはブラウザーアプリを変更する場合は、その領域の package.json とアーキテクチャガイドに記載されたチェックも実行してください。

パッケージとプロジェクト領域

パス	内容
packages/sdk	@oya-ai/browser、TypeScript SDK（MIT）
packages/cli	@oya-ai/cli、セットアップおよびコマンドラインツール（MIT）
browser	Oya のデスクトップブラウザーとクラウドブラウザーイメージ
server	API、ブラウザー接続、MCP、コントロールプレーン
ui	Web コンソールと公開サイト
examples	SDK とブラウザー連携のサンプル
docs	運用ガイドと製品の詳細

ライセンス

SDK と CLI は MIT ライセンスで提供されています。プロジェクトのその他の部分は Sustainable Use License の下で利用できます。許可される利用方法、セルフホストの条件、商用ライセンスの詳細については、LICENSE.mdをご覧ください。