AI Agent Automation
Get Started

Installation

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

Prerequisites

Node.js 18.x or higher
MongoDB (local or Atlas)
npm or yarn
LLM API Key (OpenAI, Gemini, Groq, etc.)

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

3
Run Backend & Worker

The backend handles APIs and state. The worker executes workflows. Run them in separate terminals.

# Terminal 1 (API server)
npm run dev
# Terminal 2 (Worker / Step Runner)
npm run worker

4
Start the Frontend

The frontend provides the dashboard and workflow UI.

cd frontend
npm install
npm run dev

Verify Installation

If everything is running correctly:

  • Frontend is available at http://localhost:3000
  • Backend API runs on http://localhost:5000
  • Worker logs show step execution activity