{"id":24727020,"url":"https://github.com/cloudycotton/browser-operator","last_synced_at":"2025-03-22T14:41:01.392Z","repository":{"id":274306427,"uuid":"922411304","full_name":"cloudycotton/browser-operator","owner":"cloudycotton","description":"Build your own AI operators like OpenAI","archived":false,"fork":false,"pushed_at":"2025-01-27T18:55:56.000Z","size":34,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-22T06:16:03.064Z","etag":null,"topics":["ai","anthropic","browser","browser-agent","computer-use","javascript","nextjs","nodejs","open-operator","openai","playwright","typescript"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cloudycotton.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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-26T05:53:13.000Z","updated_at":"2025-02-13T20:29:56.000Z","dependencies_parsed_at":null,"dependency_job_id":"62f3e23b-9923-4f5a-95a3-9b4db343fbbf","html_url":"https://github.com/cloudycotton/browser-operator","commit_stats":null,"previous_names":["cloudycotton/browser-operator","cloudycotton/browser_operator"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudycotton%2Fbrowser-operator","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudycotton%2Fbrowser-operator/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudycotton%2Fbrowser-operator/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cloudycotton%2Fbrowser-operator/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cloudycotton","download_url":"https://codeload.github.com/cloudycotton/browser-operator/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244973701,"owners_count":20541021,"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":["ai","anthropic","browser","browser-agent","computer-use","javascript","nextjs","nodejs","open-operator","openai","playwright","typescript"],"created_at":"2025-01-27T14:42:49.417Z","updated_at":"2025-03-22T14:41:01.386Z","avatar_url":"https://github.com/cloudycotton.png","language":"TypeScript","readme":"\u003cdiv align=\"center\"\u003e\n\n### Browser Operator\n\nBuild your own AI operators like OpenAI\n\n[![MIT License](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE) [![Discord](https://img.shields.io/badge/discord-purple.svg)](https://discord.gg/3YfJeg7pNp)\n\nhttps://github.com/user-attachments/assets/a7196eef-d3a0-401b-89aa-eb06f4a5f3d9\n\n\u003c/div\u003e\n\n## 📦 Installation\n\n```bash\nnpm install browser-operator\n```\n\n### Environment\n\nThe framework depends on the following environment variables:\n\n- `ANTHROPIC_API_KEY` - API Key for Claude.\n\n```shell\n# Set the API key in the shell before running.\nexport ANTHROPIC_API_KEY=your-api-key\n```\n\n\u003e Support for other models is coming. Please open an issue for models you want to see.\n\n## 🔧 Usage\n\n```ts\nimport { BrowserOperator } from \"browser-operator\";\n\nconst operator = await BrowserOperator.create();\n\nconst response = await operator.page.act(\n  \"go to hackernews, click on comments of top post, print the title and top comment.\"\n);\n\nawait operator.stop();\n\nconsole.log(response);\nconsole.log(operator.page._generateScript()); // experimental script generation. Methods starting with _ are not stable.\n```\n\n## Terminal Usage\n\nThere is an included CLI tool that can be used to act on instructions from the command line or from a file.\n\n```bash\n# Pass the instruction from the command line\nnpx browser-operator \"go to hackernews, click on comments of top post, print the title and top comment.\"\n\n# Pass the instruction from a file\nnpx browser-operator instruction.txt\n\n# Generate deterministic script of actions taken by the operator. This is experimental and may not work reliably. Next time, you run the same command with --generate-script flag, generated script will be run instead of operator.\nnpx browser-operator \"go to hackernews, click on comments of top post, print the title and top comment.\" --generate-script\n\n```\n\n## 🙏 Acknowledgements\n\nThis project is heavily inspired by [StageHead](https://github.com/browserbase/stagehand).\n\n## 📄 License\n\nThis project is licensed under the [MIT License](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudycotton%2Fbrowser-operator","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcloudycotton%2Fbrowser-operator","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcloudycotton%2Fbrowser-operator/lists"}