Oya Browser

The browser for regulated industries (community version).

People and AI agents work together in one browser, with control over where it runs and how it is governed.

Download Oya Browser · Get started in the cloud · Self-host Oya · For enterprise, contact sales@getoya.ai

A run in the Oya desktop app, sped up. The portal and patient data are fictional. Watch run 1 · run 2 · run 3.

This repository contains the Oya Browser community edition. People and AI agents work together in one browser: agents can use an existing signed-in browser, start managed cloud browsers, or connect through familiar tools and APIs. People can watch the work, step in when needed, and keep control of browser access and repeatable tasks.

The enterprise edition, including the HIPAA-ready offering, is maintained in a separate private repository. Contact sales@getoya.ai to learn about that edition.

Choose how to get started

Use Oya with an AI assistant

Install the desktop app, sign in, and connect your assistant from the app. Oya works with Claude Code, Codex, Cursor and VS Code. People can see the agent's browser activity and take control when a task needs their attention.

Download the desktop app · Agent setup guide

Control a browser from Node.js

Install the SDK and create an API key at oyabrowser.com. Node.js 20 or newer is required.

npm install @oya-ai/browser

Set OYA_API_KEY, then run:

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();
}

With no browser provider configured, start() can use the Oya desktop browser already connected to your account. To start cloud or self-hosted browsers, configure a provider with npx @oya-ai/cli init. The SDK and CLI can also use Browserbase, Steel, Anchor, Browser Use, or a browser you provide. Your application can keep the same SDK calls when you change providers.

SDK guide · Runnable examples · CLI guide

Connect over MCP

For assistants that support remote MCP, connect to https://oyabrowser.com/mcp/pool and authenticate with your Oya API key. For Claude Code:

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

Use the same endpoint with your self-hosted server URL when you run your own deployment.

Agent instructions and MCP reference

For AI agents

Use the agent reference for setup instructions, available tools, SDK examples, and MCP configuration. The desktop app can pair with Claude Code, Codex, Cursor, and VS Code. For remote MCP clients, connect to https://oyabrowser.com/mcp/pool with your Oya API key.

Run Oya in your own environment

Use the installer to set up a self-hosted instance:

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