AI Agent Automation
Get Started

Installation

Set up the AI Agent Automation Platform locally or with Docker. No cloud required. Everything runs on your machine.

Prerequisites

Node.js 18.x or higher
MongoDB 7.x (local or Atlas, must be a replica set)
npm or yarn
LLM API Key (OpenAI, Gemini, Groq, Ollama, or Hugging Face)

Setup Steps

1
Clone the Repository

git clone https://github.com/vmDeshpande/ai-agent-automation.git
cd ai-agent-automation

2
Backend Configuration

Install backend dependencies and configure environment variables.

cd backend
npm install
cp .env.example .env

Edit backend/.env and fill in the required values:MONGO_URI, JWT_SECRET, and at least one LLM provider key.

3
Frontend Configuration

Install frontend dependencies.

cd ../frontend
npm install

4
Start MongoDB

MongoDB must run with a replica set enabled. For local development, start mongod with the --replSet flag, or use Docker:

docker run -d -p 27017:27017 --name mongo mongo:7 --replSet rs0 --bind_ip_all

5
Start the Backend

cd backend
npm run dev

The API server starts on http://localhost:5000.

6
Start the Worker

Open a new terminal and start the worker process. The worker polls for pending tasks and executes workflow steps.

cd backend
npm run worker

7
Start the Frontend

cd frontend
npm run dev

Open http://localhost:3000 in your browser.

Docker Quick Start

The fastest way to run the complete platform is with Docker Compose. It provisions MongoDB with a replica set, the backend API, the worker, the frontend, and an optional nginx proxy.

cp infra/.env.example infra/.env
docker compose up --build

Access the frontend at http://localhost:3000 and the API at http://localhost:5000.