https://github.com/testdriverai/testdriverai
Computer-Use SDK for E2E QA Testing
https://github.com/testdriverai/testdriverai
ag agentic-ai agents computer-use e2e e2e-testing javascript test-automation testing testing-tools vitest
Last synced: about 20 hours ago
JSON representation
Computer-Use SDK for E2E QA Testing
- Host: GitHub
- URL: https://github.com/testdriverai/testdriverai
- Owner: testdriverai
- Created: 2024-08-25T21:30:13.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2026-02-05T02:03:35.000Z (7 days ago)
- Last Synced: 2026-02-05T07:58:53.894Z (7 days ago)
- Topics: ag, agentic-ai, agents, computer-use, e2e, e2e-testing, javascript, test-automation, testing, testing-tools, vitest
- Language: JavaScript
- Homepage: https://testdriver.ai
- Size: 23.3 MB
- Stars: 211
- Watchers: 4
- Forks: 33
- Open Issues: 3
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
Awesome Lists containing this project
- awesome_ai_agents - Testdriverai - Next generation autonomous AI agent for end-to-end testing of web & desktop (Building / Testing)
- awesome-a2a-agents - testdriverai/cli - Next generation autonomous AI agent for end-to-end testing of web & desktop (Agent Categories / <a name="Unclassified"></a>Unclassified)
README
Computer-Use SDK for E2E QA Testing
The TestDriver SDK is a JS plugin for vitest that makes it easy to spawn ephemeral devices and use vision-based LLMs to construct detemanistic and reliable tests.
[🚀 **Quick Start**](#-quick-start) • [📖 **Documentation**](https://docs.testdriver.ai) • [💻 **Examples**](https://github.com/testdriverai/testdriverai/tree/main/examples) • [📖 **Pricing**](https://docs.testdriver.ai) • [💬 **Discord**](https://discord.com/invite/cWDFW8DzPm) • [🌐 **Website**](https://testdriver.ai)
---
## Why TestDriver?
Don't ship bugs because flows are too hard to test. TestDriver helps engineering teams easily test, debug, and monitor E2E flows that are hard or impossible to cover with other tools like:
*Third-Party Web Apps* • *Desktop Apps* • *VS Code Extensions* • *Chrome Extensions* • *AI Chatbots* • *OAuth Flows* • *PDF Content* • *Spelling & Grammar* • *File System & Uploads* • *OS Accessibility* • *Visual Content* • *``* • *``* • *``*
## Example
```js
// Click on the new text document
await testdriver.find("New text document").mouseDown();
// Drag the "New Text Document" icon to the "Recycle Bin"
await testdriver.find("Recycle Bin icon").mouseUp();
// Assert "New Text Document" icon is not on the Desktop
const result = await testdriver.assert(
'the "New Text Document" icon is not visible on the Desktop'
);
expect(result).toBeTruthy();
```
[See Full Example](https://github.com/testdriverai/testdriverai/blob/main/examples/drag-and-drop.test.mjs) • [Browse All Examples](https://github.com/testdriverai/testdriverai/tree/main/examples)
---
## 🚀 Quick Start
### Step 1: Create a TestDriver Account
*No credit card required!*
### Step 2: Initialize Your Project
```bash
npx testdriverai init
```
This will:
- Create a project folder
- Install dependencies (Vitest + TestDriver)
- Set up your API key
- Generate an example test
### Step 3: Run Your First Test
```bash
vitest run
```
Watch as TestDriver:
1. Spawns a cloud sandbox
2. Launches Chrome
3. Runs your test using AI vision
4. Returns results with video replay
