{"id":30190828,"url":"https://github.com/browser-use/qa-use","last_synced_at":"2026-03-27T02:44:24.015Z","repository":{"id":308377454,"uuid":"1024356290","full_name":"browser-use/qa-use","owner":"browser-use","description":null,"archived":false,"fork":false,"pushed_at":"2025-07-30T15:06:54.000Z","size":2406,"stargazers_count":62,"open_issues_count":1,"forks_count":6,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-05T16:58:01.394Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/browser-use.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,"zenodo":null}},"created_at":"2025-07-22T15:12:03.000Z","updated_at":"2025-08-05T10:04:56.000Z","dependencies_parsed_at":"2025-08-05T17:11:08.389Z","dependency_job_id":null,"html_url":"https://github.com/browser-use/qa-use","commit_stats":null,"previous_names":["browser-use/qa-use"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/browser-use/qa-use","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fqa-use","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fqa-use/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fqa-use/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fqa-use/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/browser-use","download_url":"https://codeload.github.com/browser-use/qa-use/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/browser-use%2Fqa-use/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270127392,"owners_count":24531793,"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","status":"online","status_checked_at":"2025-08-12T02:00:09.011Z","response_time":80,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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-08-12T20:09:07.021Z","updated_at":"2026-03-27T02:44:18.980Z","avatar_url":"https://github.com/browser-use.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"![qa use](/static/qa-use-banner.png)\n\n**AI-Powered E2E Testing Platform** ✨\n\n\u003e A comprehensive, production-ready QA testing solution powered by BrowserUse AI agents. Automate your web application testing with intelligent agents that think, act, and validate like human testers—but faster, more consistently, and around the clock.\n\n[![Docker](https://img.shields.io/badge/Docker-Ready-blue?logo=docker)](https://docker.com) [![BrowserUse](https://img.shields.io/badge/BrowserUse-Integrated-green)](https://browser-use.com) [![Next.js](https://img.shields.io/badge/Next.js-15-black?logo=next.js)](https://nextjs.org) [![TypeScript](https://img.shields.io/badge/TypeScript-Ready-blue?logo=typescript)](https://typescriptlang.org)\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"media/run.png\" alt=\"Test Run in Progress\" width=\"600px\"\u003e\n  \u003cimg src=\"media/editor.png\" alt=\"Test Run in Progress\" width=\"600px\"\u003e\n\u003c/p\u003e\n\n## 🚀 Quick Start Guide\n\n### Prerequisites\n\n- 🐳 **Docker** \u0026 Docker Compose installed\n- 🔑 **BrowserUse API Key** (get yours at [cloud.browser-use.com](https://cloud.browser-use.com/billing))\n- 📧 **Resend API Key** (optional, for email notifications)\n\n### ⚡ 3-Step Setup\n\n```bash\n# 1️⃣ Clone the repository\ngit clone https://github.com/browser-use/qa-use.git\ncd qa-use\n\n# 2️⃣ Configure environment variables\ncp .env.example .env\n# Edit .env and add your API keys\n\n# 3️⃣ Launch the platform\ndocker compose up\n```\n\n## ✨ Key Features \u0026 Highlights\n\n1. 🤖 **AI-Powered Testing Engine** - Leverages BrowserUse to evaluate test cases in plain English.\n1. 🎯 **Advanced Test Management** - Organize tests into suites and run multiple tests in parallel.\n1. ⏰ **Automated Scheduling \u0026 Monitoring** - Configure suites to run hourly or daily automatically.\n1. 📧 **Smart Notifications** - Get an email notification when a test suite fails.\n\n🎉 **That's it!** Visit [http://localhost:3000](http://localhost:3000) to start creating your first test suite.\n\n### 🔧 Environment Variables\n\nCreate a `.env` file with the following:\n\n```env\n# Required: BrowserUse API Integration\nBROWSER_USE_API_KEY=your_browseruse_api_key_here\n\n# Database Configuration\nDATABASE_URL=postgresql://postgres:postgres@postgres:5432/qa-use\n\n# Optional: Email Notifications\nRESEND_API_KEY=your_resend_api_key_here\n\n# Optional: Inngest Configuration (for production)\nINNGEST_SIGNING_KEY=your_inngest_signing_key\nINNGEST_BASE_URL=http://inngest:8288\n```\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"media/suite.png\" alt=\"Test Suite Interface\" width=\"600px\"\u003e\n\u003c/p\u003e\n\n## 💡 How It Works\n\n### 🎯 **Intelligent Test Execution**\n\n1. **Define Your Test**: Write test steps in natural language\n\n   ```\n   Steps:\n   1. Go to example.com\n   2. Click the search button\n   3. Type \"laptop\" in the search field\n   4. Press enter and wait for results\n\n   Success Criteria:\n   The page should show at least 3 laptop search results\n   ```\n\n2. **AI Agent Takes Over**: BrowserUse AI agents execute your test\n   - Navigate to pages like a human user\n   - Interact with elements intelligently\n   - Handle unexpected popups and dialogs\n   - Adapt to layout changes and dynamic content\n\n3. **Smart Validation**: AI evaluates results against your criteria\n   - Checks final page state precisely\n   - Compares actual vs. expected outcomes\n   - Provides detailed pass/fail reports\n   - Captures screenshots and recordings\n\n## 🤝 Contributing\n\nWe welcome contributions! This project showcases the full capabilities of BrowserUse and serves as a reference implementation for AI-powered testing platforms.\n\n### Development Setup\n\n```bash\n# Start development environment\ndocker compose -f docker-compose.dev.yaml up --watch\n\n# Run type checking\npnpm run test:types\n```\n\n## 📚 Resources \u0026 Links\n\n- 🤖 **[BrowserUse Documentation](https://docs.browser-use.com)** - Learn about AI browser automation\n- 🌐 **[BrowserUse Cloud](https://cloud.browser-use.com)** - Try BrowserUse in your browser\n- 📧 **[Resend Documentation](https://resend.com/docs)** - Email integration guide\n- ⚡ **[Inngest Documentation](https://inngest.com/docs)** - Background job processing\n\n## 📄 License\n\nThis project is open source and available under the [MIT License](LICENSE).\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n**Built with ❤️ by the BrowserUse team**\n\n[⭐ Star on GitHub](https://github.com/browser-use/qa-use) • [🐛 Report Bug](https://github.com/browser-use/qa-use/issues) • [💡 Request Feature](https://github.com/browser-use/qa-use/issues)\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fqa-use","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrowser-use%2Fqa-use","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrowser-use%2Fqa-use/lists"}