{"id":25040666,"url":"https://github.com/browserbase/open-operator","last_synced_at":"2025-10-20T23:31:29.177Z","repository":{"id":274066760,"uuid":"921427592","full_name":"browserbase/open-operator","owner":"browserbase","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-06T00:31:17.000Z","size":799,"stargazers_count":994,"open_issues_count":15,"forks_count":183,"subscribers_count":17,"default_branch":"main","last_synced_at":"2025-02-06T01:24:41.560Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://operator.browserbase.com/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/browserbase.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2025-01-23T23:36:18.000Z","updated_at":"2025-02-06T00:49:44.000Z","dependencies_parsed_at":"2025-01-24T17:43:10.347Z","dependency_job_id":null,"html_url":"https://github.com/browserbase/open-operator","commit_stats":null,"previous_names":["browserbase/open-operator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fopen-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fopen-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fopen-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browserbase%2Fopen-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browserbase","download_url":"https://codeload.github.com/browserbase/open-operator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":237407889,"owners_count":19305193,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-02-06T03:04:34.605Z","updated_at":"2025-10-20T23:31:23.870Z","avatar_url":"https://github.com/browserbase.png","language":"TypeScript","readme":"# Open Operator\n\n\u003e [!WARNING]\n\u003e This is simply a proof of concept.\n\u003e Browserbase aims not to compete with web agents, but rather to provide all the necessary tools for anybody to build their own web agent. We strongly recommend you check out both [Browserbase](https://www.browserbase.com) and our open source project [Stagehand](https://www.stagehand.dev) to build your own web agent.\n\n[![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/clone?repository-url=https%3A%2F%2Fgithub.com%2Fbrowserbase%2Fopen-operator\u0026env=OPENAI_API_KEY,BROWSERBASE_API_KEY,BROWSERBASE_PROJECT_ID\u0026envDescription=API%20keys%20needed%20to%20run%20Open%20Operator\u0026envLink=https%3A%2F%2Fgithub.com%2Fbrowserbase%2Fopen-operator%23environment-variables)\n\n## Getting Started\n\nFirst, install the dependencies for this repository. This requires [pnpm](https://pnpm.io/installation#using-other-package-managers).\n\n\u003c!-- This doesn't work with NPM, haven't tested with yarn --\u003e\n\n```bash\npnpm install\n```\n\nNext, copy the example environment variables:\n\n```bash\ncp .env.example .env.local\n```\n\nYou'll need to set up your API keys:\n\n1. Get your OpenAI API key from [OpenAI's dashboard](https://platform.openai.com/api-keys)\n2. Get your Browserbase API key and project ID from [Browserbase](https://www.browserbase.com)\n\nUpdate `.env.local` with your API keys:\n\n- `OPENAI_API_KEY`: Your OpenAI API key\n- `BROWSERBASE_API_KEY`: Your Browserbase API key\n- `BROWSERBASE_PROJECT_ID`: Your Browserbase project ID\n\nThen, run the development server:\n\n\u003c!-- This doesn't work with NPM, haven't tested with yarn --\u003e\n\n```bash\npnpm dev\n```\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see Open Operator in action.\n\n## How It Works\n\nBuilding a web agent is a complex task. You need to understand the user's intent, convert it into headless browser operations, and execute actions, each of which can be incredibly complex on their own.\n\n![public/agent_mess.png](public/agent_mess.png)\n\nStagehand is a tool that helps you build web agents. It allows you to convert natural language into headless browser operations, execute actions on the browser, and extract results back into structured data.\n\n![public/stagehand_clean.png](public/stagehand_clean.png)\n\nUnder the hood, we have a very simple agent loop that just calls Stagehand to convert the user's intent into headless browser operations, and then calls Browserbase to execute those operations.\n\n![public/agent_loop.png](public/agent_loop.png)\n\nStagehand uses Browserbase to execute actions on the browser, and OpenAI to understand the user's intent.\n\nFor more on this, check out the code at [this commit](https://github.com/browserbase/open-operator/blob/6f2fba55b3d271be61819dc11e64b1ada52646ac/index.ts).\n\n### Key Technologies\n\n- **[Browserbase](https://www.browserbase.com)**: Powers the core browser automation and interaction capabilities\n- **[Stagehand](https://www.stagehand.dev)**: Handles precise DOM manipulation and state management\n- **[Next.js](https://nextjs.org)**: Provides the modern web framework foundation\n- **[OpenAI](https://openai.com)**: Enable natural language understanding and decision making\n\n## Contributing\n\nWe welcome contributions! Whether it's:\n\n- Adding new features\n- Improving documentation\n- Reporting bugs\n- Suggesting enhancements\n\nPlease feel free to open issues and pull requests.\n\n## License\n\nOpen Operator is open source software licensed under the MIT license.\n\n## Acknowledgments\n\nThis project is inspired by OpenAI's Operator feature and builds upon various open source technologies including Next.js, React, Browserbase, and Stagehand.\n","funding_links":[],"categories":["By Industry","By Language","TypeScript","Deep Research Agents"],"sub_categories":["Web Development","TypeScript","General Deep Research Agents"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserbase%2Fopen-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowserbase%2Fopen-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowserbase%2Fopen-operator/lists"}