Skip to content
BranchesTags

Repository files navigation

🏗️ Construction AI Agent System

Enterprise Multi-Agent Platform & Autonomous LangGraph Orchestrator

Sponsored & Developed by Data Daur

Bun Version Elysia.js LangGraph MongoDB Redis License: MIT

Eliminating the $177 Billion Annual Loss in Construction Operations through Autonomous AI Multi-Agent Orchestration.

🏢 About Data Daur • 🖼️ UI Showcase • 🚀 Quick Start • ✨ Key Features • 🏛️ Architecture

🏢 Sponsored & Developed By

This open-source project is proudly sponsored, engineered, and maintained by Data Daur AI & ERP Consulting.

Data Daur specializes in empowering global enterprises with tailored Artificial Intelligence, autonomous multi-agent systems, data engineering pipelines, and custom ERP integration services across Construction, Manufacturing, Logistics, and Corporate Operations.

🌐 Website: www.datadaur.com
✉️ Enterprise Inquiries: contact@datadaur.com

📌 Overview

The Construction AI Agent System is a production-ready, open-source multi-agent platform designed to bridge information silos and automate operations across Construction, Manufacturing, and HR departments.

Powered by a Dynamic Intelligence Intent Layer (IntelligentIntentLayer.ts) harvesting live tool schemas, LangGraph StateGraph Workflows (v2.x), and the Issa Group Enterprise Knowledge Base & Policy Engine, the system dynamically classifies user queries ("What is our WFH policy, onboard Sarah as an engineer, order 500 steel beams, and estimate site timeline") into parallel or sequential execution tasks across specialized AI agents.

🖼️ Interface & UX Showcase

💬 1. Unified Intelligence Terminal & @-Mention Autocomplete

Full-screen dark mode ChatGPT-style terminal with @ tool autocomplete, voice-to-text speech input, and multi-thread session switcher.

Unified Intelligence Terminal


👥 2. HR Workforce Directory Hub

Interactive employee directory featuring Employee IDs (EMP001), live search filtering, and CRUD management modals.

Workforce Directory Overview Add & Edit Employee Modal
HR Hub Overview HR Modal View

🏗️ 3. Site Terminal — Construction Hub

Real-time construction project tracking featuring Project IDs (PRJ-001), site locations, budgets, and visual progress bars.

Construction Site Terminal


🏭 4. Fabrication Node — Manufacturing Hub

Plant inventory management featuring SKUs (STEEL-001), stock level controls, unit costs, and live OEE performance metrics.

Manufacturing Fabrication Node


🌐 5. LangGraph Enterprise Workflow Center

Multi-step StateGraph orchestration wizard for executing autonomous cross-department enterprise workflows.

LangGraph Workflow Wizard


🔔 6. Toast Notifications & In-Chat File Downloads

Real-time floating animated alerts (success, error, info, warning) and interactive file download cards for CSV, Excel, and PDF reports.

Toast & Downloads

✨ Key Features & Capabilities

┌───────────────────────────────────────────────────────────────────────────────────────────┐
│                                   🌟 PLATFORM HIGHLIGHTS                                  │
├───────────────────────────────┬───────────────────────────────┬───────────────────────────┤
│ 🏗️ Construction Agent        │ 🏭 Manufacturing Agent        │ 👥 HR Agent               │
│ • Project Tracker & CRUD      │ • Inventory Tracker & SKUs    │ • Employee Directory CRUD │
│ • Material Cost Calculator    │ • OEE Production Metrics      │ • Onboarding Checklists   │
│ • Timeline Estimator          │ • Quality Control Logging     │ • Vacation & Leave Balances│
│ • OSHA Safety Checklists      │ • Equipment Maintenance       │ • Performance Trackers    │
├───────────────────────────────┼───────────────────────────────┼───────────────────────────┤
│ 🌐 LangGraph Workflows        │ 🎨 Terminal & User Experience │ 📄 Reports & Exports      │
│ • Company Control Orchestration│ • `@` Tool Autocomplete Menu  │ • CSV Export Generator    │
│ • 15-Step Employee Onboarding │ • 🎙️ Voice-to-Text Speech     │ • Excel Sheet Exporter    │
│ • Project Kickoff Pipelines   │ • 💬 Multi-Thread Sessions    │ • PDF Document Renderer   │
│ • Inventory Restock Trigger   │ • 🔔 Animated Toast Alerts    │ • In-Chat Download Cards  │
└───────────────────────────────┴───────────────────────────────┴───────────────────────────┘

🏛️ System Architecture

                       [ User / Web Terminal UI (React 18 + Vite) ]
                                            │
                      ┌─────────────────────┴─────────────────────┐
                      ▼                                           ▼
        ⚡ Fast REST Agent Router                    🌐 LangGraph Workflow Center
       (Groq LLM + 429 Retry Backoff)               (StateGraph Workflow Engine)
                      │                                           │
       ┌──────────────┼──────────────┐             ┌──────────────┼──────────────┐
       ▼              ▼              ▼             ▼              ▼              ▼
 🏗️ Construction    👥 HR     🏭 Manufacturing  Kickoff     Onboarding     Control
    Agent          Agent          Agent       Workflow      Workflow      Workflow
       │              │              │             │              │              │
       └──────────────┴──────────────┴─────────────┴──────────────┴──────────────┘
                                            │
                               ┌────────────┴────────────┐
                               ▼                         ▼
                       🍃 MongoDB 7.5            ⚡ Redis 5.11
                     (Text Indexes Active)     (Session Token Cache)

🚀 Quick Start

1. Prerequisites

2. Clone & Setup Repository

# Clone the open-source repository
git clone https://github.com/tayyabmughal676/Construction_AI_Agent.git
cd Construction_AI_Agent

# Install dependencies for backend and frontend
bun install
cd frontend && bun install && cd ..

3. Configure Environment Variables

cp .env.example .env

Default environment parameters:

PORT=3000
MONGODB_URI=mongodb://localhost:27017/multi-ai-agency
MONGODB_DB_NAME=multi-ai-agency
REDIS_HOST=localhost
REDIS_PORT=6379
GROQ_API_KEY=your_groq_api_key_here
JWT_SECRET=super_secret_jwt_key_2026

4. Start Infrastructure & Seed Demo Data

# Start MongoDB & Redis Docker containers
docker-compose up -d

# Seed database with rich enterprise demo data
bun run seed

5. Launch Application

# Run both Backend API server & Frontend UI concurrently
bun run dev
  • Backend API: http://localhost:3000
  • Frontend UI: http://localhost:5173
  • Demo Admin Credentials: admin@example.com / admin123
  • Demo User Credentials: user@example.com / user123

📖 API Reference & Example Workflows

⚡ Agent Natural Language Chat

POST /api/agents/chat

curl -X POST http://localhost:3000/api/agents/chat \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_JWT_TOKEN>" \
  -d '{"message": "@project_tracker list all active sites"}'

🌐 LangGraph Company Control Super Orchestrator

POST /api/workflows/langgraph/company-control

curl -X POST http://localhost:3000/api/workflows/langgraph/company-control \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <YOUR_JWT_TOKEN>" \
  -d '{"context":{"message":"Onboard Sarah as engineer and check steel beam stock"}}'

📊 Available REST Endpoints

Endpoint Method Description
/api/auth/login POST Authenticate user & receive JWT token
/api/agents/capabilities GET Retrieve system capabilities & active tools
/api/agents/chat POST Execute natural language query via Intelligent Router
/api/hr/employees GET/POST/PUT/DELETE Full CRUD operations for workforce directory
/api/construction/projects GET/POST/PUT/DELETE Full CRUD operations for construction sites
/api/manufacturing/inventory GET/POST/PUT/DELETE Full CRUD operations for plant inventory
/api/workflows/list GET List available LangGraph StateGraph workflows
/api/files/:type/:filename GET Download generated CSV, Excel, or PDF reports

📂 Repository Structure

.
├── frontend/                 # React 19 + Vite + TailwindCSS Modular UI Application
│   ├── src/
│   │   ├── types/            # Shared TypeScript type definitions
│   │   ├── constants/        # Department themes, icons, navigation, & suggestion chips
│   │   ├── services/         # Centralized API client (ApiService)
│   │   ├── hooks/            # Custom hooks (useAuth, useChatThreads, useSpeechRecognition, useMentionTools)
│   │   ├── components/       # UI Components
│   │   │   ├── auth/         # AuthScreen (Login / Registration)
│   │   │   ├── layout/       # Sidebar & Header layout chrome
│   │   │   ├── chat/         # ChatTerminal, MessageItem, FileDownloadCard, ChatInput, WelcomeScreen
│   │   │   └── Hubs/Modals   # HR, Construction, Manufacturing, Workflow, ApprovalModal, DeleteModal, Toast
│   │   ├── App.tsx           # Declarative Root Orchestrator
│   │   └── main.tsx          # ToastProvider & React entry
├── screenshots/              # UI/UX Screenshots & Gallery
├── src/                      # Elysia.js Hardened Backend Application
│   ├── agents/               # Domain Agents, Registry & Dynamic Intent Layer
│   ├── config/               # Logger, env validator, and capability configurations
│   ├── db/                   # MongoDB client, text indexes, models & Redis connection
│   ├── middleware/           # Auth, RBAC, and rate limiting security middleware
│   ├── routes/               # API endpoint route handlers (auth, agents, v2graph, hubs, files)
│   ├── services/             # Groq LLM & LM Studio AI integration
│   ├── tools/                # 16 specialized domain, communication & exporter tools
│   ├── workflows/langgraph/  # LangGraph v2 MultiAgentSwarmGraph & 6 enterprise workflows
│   └── seed.ts               # Enterprise database seeder
├── test/                     # 54 Automated Unit & Security Test Suites
├── docker-compose.yml        # Local MongoDB & Redis stack
├── AGENTS.md                 # Agent architecture & tool specifications
├── CHANGELOG.md              # Project version release history
├── SECURITY.md               # Full Security Vulnerability Assessment & Resolution Matrix
├── v2-work.md                # 2-Phase V2 Swarm Engine roadmap
└── README.md                 # Project documentation

🤝 Contributing to Open Source

Contributions are warmly welcomed! Please follow these steps:

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add amazing feature')
  4. Verify TypeScript compilation (bun test and npx tsc --noEmit)
  5. Push to the branch (git push origin feature/amazing-feature)
  6. Open a Pull Request

📝 License

Distributed under the MIT License. See LICENSE for more information.

Sponsored & Developed by Data Daur AI & ERP Consulting

🌐 www.datadaur.com • ✉️ contact@datadaur.com

Built with ❤️ for the Global Construction & Industrial Sector

About

Introducing a game-changing Agentic AI System for the Construction Industry! 🤖 This powerful AI Agent is designed to revolutionize operations across multiple departments, including Construction, Manufacturing, HR, and more. 🚧🏗️💻

datadaur.com

Topics

agentic-aiagentic-workflowaiai-agentai-agentsbunjsconstructionconstruction-aiconstruction-industrymongodb

Resources

Readme

Security policy

Security policy
Activity

Stars

2 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

Packages

Contributors

Languages