AI QA Engineer

A web-based system for automated browser tests using Gherkin syntax and an open-source browser-use agent.

Project Overview

The AI QA Engineer is a web-based system designed to streamline the creation, management, and execution of automated browser tests. It leverages an existing open-source browser-use agent and provides a user-friendly interface for test management, allowing QA engineers to write test cases in Gherkin syntax (Given-When-Then format) and organize them into test suites.

System Architecture

The system follows a modern, microservices-oriented architecture with clear separation of concerns:

• Frontend: Next.js with Tailwind CSS
• Backend: FastAPI (Python)
• Database: MongoDB
• Browser Automation: Open-source browser-use agent
• Containerization: Docker

For more details, see the system architecture documentation.

Getting Started

Prerequisites

• Node.js (v18+)
• Python (v3.10+)
• Docker and Docker Compose
• MongoDB (or use the provided Docker container)

Development Setup

1. Clone the repository

git clone https://github.com/your-org/ai-qa-engineer.git
cd ai-qa-engineer

2. Setup Frontend

cd frontend
npm install
npm run dev

The frontend will be available at http://localhost:3000

3. Setup Backend

cd backend
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt
uvicorn app.main:app --reload

The backend API will be available at http://localhost:8000

4. Start with Docker (optional)

docker-compose up -d

This will start the entire stack (frontend, backend, and MongoDB) in development mode.

MongoDB Setup

If you want to run only MongoDB in a Docker container:

# Start MongoDB container
docker run -d -p 27017:27017 --name mongodb mongo:latest

# Verify MongoDB is running
docker ps | findstr mongodb

To use MongoDB with the application:

1. Ensure USE_MOCK_DB is set to False in backend/app/core/config.py or in your .env file
2. Start the backend application:

cd backend
python -m app.main

Documentation

• Project Overview
• System Architecture
• Component Specifications
• Implementation Plan
• Gherkin Reference Guide
• API Documentation

License

MIT License