Dex — Workflow Automation Platform

Visual workflow automation with AI agents, Gmail integration, and event-driven execution

Dex is a full-stack workflow automation platform that lets you build, visualize, and execute complex workflows using a node-based interface. Connect Gmail, AI agents, and third-party services to automate repetitive tasks.

---

Features

• Visual Workflow Builder — Drag-and-drop nodes using React Flow
• Event-Driven Execution — BullMQ + Redis for concurrent job processing
• Gmail API Integration — Read, filter, and send emails via OAuth2
• AI Integration — Gemini AI for intelligent email processing and responses
• DAG Execution Engine — Dependency resolution with parallel execution
• Template Variables — Dynamic data flow between workflow nodes
• Modern Stack — TypeScript, Prisma, Clerk Auth, PostgreSQL
• Real-time Feedback — Live execution status and validation

---

🚀 Quick Start

Prerequisites

• Node.js 18+
• PostgreSQL 15+
• Redis 7+
• Gmail API credentials

---

Clone & Install

git clone https://github.com/Ethics03/dex-core.git
cd dex-core
npm install

---

Architecture

• Frontend: React + TypeScript + React Flow + Tailwind
• Backend: Node.js + Express + TypeScript + Prisma + BullMQ
• Database: PostgreSQL
• Queue: Redis
• Auth: Clerk
• AI: Google Gemini API
• Email: Gmail API (OAuth2)

---

Core Components

Workflow Nodes
├── Trigger Nodes
│   ├── Gmail Trigger (new email)
│   ├── Schedule Trigger (cron)
│   └── Webhook Trigger
│
├── Action Nodes
│   ├── Gmail Send
│   ├── AI Agent (Gemini)
│   ├── HTTP Request
│   └── Database Query
│
└── Logic Nodes
    ├── If / Else
    ├── Loop
    └── Merge

---

AI Features

• Email Categorization — Auto-classify incoming emails

• Smart Responses — AI-generated replies with context

• Content Extraction — Parse attachments & extract key information

• Prompt Templating — Custom AI prompts per workflow