Autopilot/master

AutoPilot Platform

AutoPilot is a high-performance web browser automation platform designed for distributed execution orchestration. It consists of three core components:

---

📂 Project Structure

localagent/
├── autopilot-ui/           # React/Vite Frontend (Web Dashboard)
├── autopilot-master/       # Cloud Coordinator Broker service (Spring Boot)
├── autopilot-worker/       # AutoPropel LocalAgent application runner (Spring Boot)
├── service-packaging/      # Windows Service wrappers and registration scripts
├── docker-compose.yml      # Local development database infrastructure
└── pom.xml                 # Workspace parent POM for the Java projects

---

🛠️ Prerequisites

• Java: JDK 21 or JDK 25 installed and configured on your PATH.
• Node.js: v18+ (for running the React UI).
• Browsers: Google Chrome and/or Mozilla Firefox installed in default system paths.
• Docker: For running the local PostgreSQL database.

---

🏗️ Local Development Setup

To run the entire distributed platform on your local machine, follow these steps in order:

1. Start the Local Database

We use Docker to spin up a local PostgreSQL database for development, so you don't need to connect to AWS. From the root of the project:

docker-compose up -d

(This starts PostgreSQL on port 5432 with credentials user: localagent, password: localagent)

2. Start the Master (Cloud Coordinator)

The Master broker manages the database, serves the API, and schedules jobs. Open a new terminal at the root of the project:

.\mvnw.cmd clean spring-boot:run -pl autopilot-master -Dspring-boot.run.profiles=default -DJWT_SECRET=supersecretjwtkeythatismorethan256bits

(The Master will start on port 9090)

3. Start the UI (React Frontend)

The frontend dashboard allows you to visually interact with the platform. Open a new terminal at the root of the project:

cd autopilot-ui
npm install
npm run dev

(The UI will start on port 5173 and proxy API requests to the Master on 9090)

4. Start the Worker (Execution Engine)

The Worker actually drives the browser and runs the tests. It will automatically connect to your local Master to fetch jobs. Open a new terminal at the root of the project:

.\mvnw.cmd clean spring-boot:run -pl autopilot-worker/localagent-java

(The Worker will start on port 8080 and begin polling http://localhost:9090 for jobs)

---

☁️ Cloud / Production Deployment

When deploying to AWS or another cloud provider:

1. Deploy autopilot-master to an EC2 instance or ECS container and point it to a managed PostgreSQL RDS database using DB_URL, DB_USER, and DB_PASS.
2. Build and deploy autopilot-ui (e.g. via S3 + CloudFront or an Nginx container).
3. Distribute the autopilot-worker to the testing nodes. Set the LOCALAGENT_CLOUD_URL environment variable on the workers to point to your public Master API.

Example for Worker:

set LOCALAGENT_CLOUD_URL=https://api.yourdomain.com
set LOCALAGENT_AGENT_ID=agent_windows_01