Skip to content

ParthivPandya/multi-agent-orchestrator

Repository files navigation

πŸš€ Multi-Agent AI Orchestrator (Enterprise Edition)

Typing SVG

Open-source enterprise AI orchestration platform with visual workflow editor, RBAC, multi-provider LLM runtime, HITL, telemetry, and production-grade governance.

8 specialized agents Β· competitor-grade feature parity Β· visual DAG editor + RBAC + enterprise controls

Next.js TypeScript Groq Vercel AI SDK Zod License: MIT

GitHub stars GitHub forks GitHub issues GitHub last commit PRs Welcome


🌟 If this project impresses you β€” and it will β€” please drop a ⭐ star. It's the best open-source AI orchestrator on GitHub. 🌟


πŸš€ Quick Start Β· πŸ† Competitor Parity Β· 🎨 Visual Pipeline Builder Β· πŸ‘₯ RBAC & Team Controls Β· πŸ€– 8 Agents Β· πŸ—οΈ Architecture Β· πŸ“‘ API Β· πŸ—ΊοΈ Roadmap


πŸ”Ž SEO Keywords

Multi-Agent AI Orchestrator, Enterprise AI Orchestration Platform, Visual Pipeline Builder, Drag and Drop AI Workflow Editor, LangFlow Alternative, Flowise Alternative, CrewAI Alternative, LangGraph Alternative, OpenDevin Alternative, RBAC for AI Agents, Human in the Loop AI, Multi-Provider LLM Orchestration, AI Agent Telemetry Dashboard, AI Workflow Automation, AI Governance Platform.


πŸ† Why This Is the Best Repo on GitHub

"This is what enterprise tools promise but never deliver β€” and it's completely free."

πŸ₯‡ What makes it extraordinary Details
πŸ’Έ Zero Cost Runs 100% on Groq's free tier. No OpenAI bills. No AWS. No subscriptions. Ever.
πŸ€– 8 Specialized AI Agents Each agent has a distinct role, skill set, and LLM β€” like a real software team
⚑ Real-time SSE Streaming Watch every agent think and write code live β€” token by token
πŸ›‘οΈ Enterprise-Grade Security OWASP Top 10 scan + GDPR/HIPAA/PCI-DSS/SOC 2 compliance built-in
🌊 14 Major Features 9 production gaps + 5 enterprise enhancements β€” more than most paid platforms
🌍 7 Languages Supported TypeScript, Python, Go, Java, Rust, Ruby, PHP β€” with idiomatic prompt injection
πŸ–ΌοΈ Vision-to-Code Upload a Figma screenshot β†’ get production component code in 30 seconds
πŸ“Š ROI Intelligence Proves your AI investment with board-ready savings metrics β€” $savings, ROI multiple, sprint days
πŸ—οΈ Technical Debt Grading Scores every codebase A–F across 6 debt categories with a prioritized backlog
⏸️ Human-in-the-Loop Approve, reject, or request changes before code continues β€” like a real review gate
🧠 Learns Your Style Remembers your preferred stack across sessions and injects it into every future run
πŸ’Ύ Never Lose Progress Checkpoints every stage to disk β€” resume from exactly where you left off
πŸ™ Ships to GitHub Pushes all generated files to a new GitHub repo in one click
🎨 Premium UI Glassmorphism dark theme, micro-animations, and a design that puts enterprise tools to shame
🧩 Visual Pipeline Builder Enterprise-grade drag-and-drop DAG editor with workflow catalog, node inspector, zoom controls, and branch visualization
πŸ‘₯ RBAC + Team Panel Admin/member/viewer roles with permission-aware UI, team management panel, and enterprise policy visibility

πŸ₯‡ Competitor Feature Parity + Enterprise Readiness

This repository now includes the missing capabilities commonly found in paid platforms:

  • βœ… Visual / Low-Code Workflow Editor (LangFlow / Flowise style)
  • βœ… Human-in-the-Loop approvals with pause/resume and decision endpoint
  • βœ… Multi-provider LLM runtime (provider/model selection per agent at run time)
  • βœ… Session memory + context persistence
  • βœ… Observability + audit export dashboard
  • βœ… Connectors + webhook-triggered orchestration
  • βœ… Team & RBAC controls (admin, member, viewer) with enterprise UI
  • βœ… Flexible DAG workflows with branching / parallel / merge nodes
  • βœ… Agent diversity + tool execution (Product, UX, code execution sandbox)

In short: this is not just a linear demo pipeline anymore - it is a production-oriented, enterprise-ready orchestration workspace.


🎨 Visual Pipeline Builder (Enterprise UX)

  • Full-screen visual workflow experience with drag-and-drop node movement
  • Workflow catalog for standard / security-first / rapid-prototype DAGs
  • Node inspector panel (conditions, human checkpoints, branch targets)
  • Zoom controls and clean edge rendering for branch readability
  • Direct "Run Workflow" execution from the builder UI

This is designed to be familiar for teams using LangFlow, Flowise, or graph-based orchestration tools.


πŸ‘₯ RBAC + Team Management (Enterprise Controls)

  • Role-based permissions: admin, member, viewer
  • Team management panel with role assignment and member lifecycle controls
  • Permission-aware UI gating for pipeline execution, settings administration, and workflow access
  • Enterprise policy visibility in-app for governance clarity

πŸ“Š 2026 Market Context β€” Why This Exists

Stat Value Source
AI-generated code worldwide 41% of all code GitHub, 2026
Annual losses from technical debt $370M (U.S. enterprise) Synergy Labs
IT budget spent on legacy maintenance Up to 80% Synergy Labs
Developers concerned about AI security 56% GitHub survey
AI programs missing goals in 2026 40% of organizations IDC
Developer productivity gain from AI 20–45% McKinsey
Enterprise apps with AI agents 40% by end of 2026 Gartner
Gartner projected AI code defects +2,500% increase Gartner, 2026

"AI-centric organizations are achieving 20–40% reductions in operating costs and 12–14 point increases in EBITDA margins." β€” McKinsey via CIO.com, Feb 2026

This repo directly solves 8 of the biggest organizational pain points AI teams face in 2026.


✨ v3 β€” 9 Enterprise Gaps Closed

These are the features that turn a "cool AI demo" into a production-grade enterprise tool.

# Feature Impact Status
1 ⏸️ Human-in-the-Loop (HITL) Approve / reject / request changes before pipeline continues. 10-min auto-approve fallback βœ… Live
2 πŸ”‘ Multi-Provider LLM Groq (free), OpenAI, Anthropic, Ollama (local) β€” per-agent model selection βœ… Live
3 βœ… Structured Output Validation Zod schema validation at every agent handoff β€” non-blocking warnings shown in activity feed βœ… Live
4 πŸ›‘οΈ Security Reviewer Agent Dedicated OWASP Top 10 scanner β€” CRITICAL/HIGH blocks deployment automatically βœ… Live
5 πŸ™ MCP GitHub Delivery One-click push of all generated files to a new GitHub repo via GitHub REST API βœ… Live
6 ⚑ Parallel Agent Execution Testing Agent runs via Promise.allSettled β€” faster pipelines, non-blocking βœ… Live
7 πŸ“‹ Full Audit Log Export Every event timestamped. Export as JSON with one click βœ… Live
8 🧠 Agent Memory Learns your tech preferences across sessions β€” injected into future prompts βœ… Live
9 🌊 Token Streaming Developer Agent streams code character-by-character via streamText βœ… Live

⚑ Phase 1 Enterprise Features (New!)

Directly addressing the $370M technical debt crisis and the enterprise security gap.

🌍 Feature 5 β€” Multi-Language Pipeline (7 Languages)

The Developer Agent now generates idiomatic, production-ready code in any of these languages β€” auto-detected from your requirements:

Language Icon Frameworks Test Framework Auto-Detected Keywords
TypeScript 🟦 Next.js, Express, NestJS, Hono Jest / Vitest react, nextjs, typescript, web
Python 🐍 FastAPI, Django, Flask, Celery pytest python, fastapi, django, ml, ai
Go 🐹 Gin, Echo, Fiber, stdlib testing + testify go, golang, grpc, goroutine
Java β˜• Spring Boot 3, JPA, Security JUnit 5 + Mockito java, spring, enterprise, kafka
Rust πŸ¦€ Axum, Tokio, SQLx, Serde cargo test rust, axum, wasm, systems
Ruby πŸ’Ž Rails 7, Sidekiq, Devise RSpec + FactoryBot ruby, rails, activerecord
PHP 🐘 Laravel 11, Symfony Pest + PHPUnit php, laravel, eloquent

How it works: Requirements Analyst output is scanned for language keywords β†’ best match selected β†’ language-specific idiom prompt injected into Developer Agent system prompt before code generation.

You: "Build a REST API for a todo app"
        ↓
Auto-detected: TypeScript (keywords: api, rest)
Language skill injected: "Use strict TypeScript, Zod validation,
                          async/await, separate route/service/repository layers..."
        ↓
Developer Agent writes idiomatic TypeScript code βœ…

πŸ—οΈ Feature 2 β€” Technical Debt Scanner Agent

Runs automatically after every pipeline as a non-blocking parallel task. Scores your generated code across 6 debt categories and produces a prioritized business backlog.

πŸ—οΈ Grade: B  |  Score: 7.2/10  |  Est. 14 hours to remediate

6 Debt Categories Measured:

Category What It Catches
πŸ›οΈ Architectural God objects, tight coupling, missing abstractions, no DI
πŸ§ͺ Testing Missing tests, brittle assertions, no edge cases, no integration tests
πŸ“ Documentation No JSDoc, undocumented APIs, missing README
πŸ”’ Security Hardcoded secrets, missing validation, no rate limiting, SQL risks
πŸ“¦ Dependency Outdated packages, known CVEs, excessive deps
⚑ Performance N+1 queries, missing caching, blocking async ops, memory leaks

Output:

{
  "debtScore": 7.2,
  "grade": "B",
  "summary": "Code is functional with good structure. Testing and documentation debt are the primary concerns.",
  "hotspots": [
    { "type": "testing", "severity": "high", "description": "No integration tests for auth routes", "effort": "M" }
  ],
  "backlogItems": [
    { "title": "Add Jest integration tests for /api/auth", "businessOutcome": "Prevents auth regressions in production", "storyPoints": 3 }
  ]
}

βš–οΈ Feature 4 β€” Compliance Agent (GDPR Β· HIPAA Β· PCI-DSS Β· SOC 2 Β· OWASP Β· DPDP)

The enterprise blocker is gone. Every generated codebase is automatically checked against 6 major compliance frameworks.

Pipeline Flow:
Security Reviewer β†’ Compliance Agent β†’ Testing Agent β†’ Deployment
                          ↓
              CRITICAL violation? β†’ Block Pipeline πŸ”΄
              HIGH violation?    β†’ HITL Required 🟑  
              MEDIUM/LOW?        β†’ Warning Only  🟒
Framework What Gets Checked
OWASP Top 10 A01-Broken Access Control, A02-Crypto Failures, A03-Injection, A07-Auth Failures
GDPR Data minimization, consent, right to erasure, cross-border transfers
HIPAA PHI encryption, access controls, audit logs, minimum necessary standard
PCI-DSS Cardholder data protection, network segmentation, key management
SOC 2 Security (CC6), Confidentiality (C1), Availability (A1), Privacy (P1-P8)
DPDP Act Data fiduciary obligations, consent, data principal rights (India)

Unlocks fintech, healthcare, legal, and government sectors for your projects.


πŸ–ΌοΈ Feature 3 β€” Vision-to-Code (Upload Design β†’ Get Code)

The #1 sprint killer is building the wrong thing. Now you can show the AI exactly what you want.

You upload: Figma screenshot / wireframe / hand-drawn sketch / UI mockup
     ↓
POST /api/vision + your framework/language choices
     ↓
Llama 4 Maverick (vision model) analyzes layout, spacing, colors, typography
     ↓
You get: Complete, responsive, accessible component code βœ…

Supported input types:

  • πŸ“Έ Figma design exports (PNG, JPG, WEBP)
  • ✏️ Hand-drawn wireframes (photographed)
  • πŸ–₯️ Existing UI screenshots (for replication or migration)
  • πŸ“„ PDF mockup pages

Options: Framework (React/Next.js/Vue/Svelte/Angular/Vanilla) Β· Language (7 supported) Β· Style Library (Tailwind/MUI/shadcn/Chakra/CSS Modules)


πŸ’° Feature 7 β€” ROI Intelligence Dashboard

"We simply cannot afford more AI investments that operate in the dark." β€” Flexera CIO, Jan 2026

Every pipeline run now comes with a board-ready ROI report to justify your AI investment.

Metrics Calculated Per Run:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  ROI Intelligence Dashboard
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  Hours Saved:          23.5h    (93% time reduction)
  Net Savings:          $2,800   per feature
  LLM Cost:             $0.003   (Groq free tier)
  ROI Multiple:         933x
  Sprint Days Saved:    2.9 days
  Annualized Value:     $145,000 /yr projected

  Cumulative (all runs):
  Total Hours Saved:    187h
  Total Savings:        $22,400
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

History persists in localStorage. Cumulative savings grow with every run. Annualized value projected from your actual usage frequency.


πŸ†• On-Demand Analysis Endpoint

POST /api/analyze β€” run technical debt + compliance analysis on ANY code, anytime:

// Request
{
  "code": "your generated or existing code here",
  "language": "python",
  "runDebt": true,
  "runCompliance": true,
  "complianceFrameworks": ["OWASP_TOP10", "GDPR", "HIPAA"],
  "industry": "healthcare"
}

// Response
{
  "debtScan": { "report": { "grade": "B", "debtScore": 7.1, "hotspots": [...] } },
  "complianceScan": { "report": { "overallScore": 82, "overallStatus": "WARNING", "frameworks": [...] } }
}

πŸ€– The 8 Agents

# Agent Model Role Max Tokens
0 🧭 Router / Classifier llama-3.1-8b-instant Classifies intent β†’ routes to optimal pipeline subset (4 modes) 512
1 πŸ” Requirements Analyst llama-3.1-8b-instant Parses English β†’ structured JSON specs + Zod validation 2,048
2 πŸ“‹ Task Planner llama-4-scout-17b Breaks specs β†’ prioritized task list with dependencies 2,048
3 πŸ’» Developer Agent qwen/qwen3-32b Writes code Β· RAG-grounded Β· web search Β· 7-language support Β· live streaming 4,096
4 πŸ”Ž Code Reviewer llama-3.3-70b-versatile Reviews code Β· lint tool Β· HITL gate Β· up to 3 revision loops 2,048
5 πŸ›‘οΈ Security Reviewer llama-3.3-70b-versatile OWASP Top 10 scan Β· CRITICAL/HIGH blocks deployment 3,072
6 πŸ§ͺ Testing Agent llama-3.3-70b-versatile Generates unit + integration tests Β· runs in parallel 3,072
7 πŸš€ Deployment Agent llama-3.1-8b-instant Dockerfile Β· docker-compose Β· GitHub Actions CI/CD 2,048

All 8 agents run with exponential backoff retry (3 attempts: 2s β†’ 4s β†’ 8s). Every agent call is logged to the audit log.

Pipeline Routing Modes

Mode Agents Tokens Saved Best For
FULL_PIPELINE All 8 β€” New feature / app build
QUICK_FIX Router + Dev + Reviewer ~60% Bug fix, small tweak
PLAN_ONLY Router + Analyst + Planner ~70% Architecture planning
CODE_REVIEW_ONLY Router + Reviewer ~80% Paste code for review

πŸ—οΈ Full Architecture

flowchart TB
    subgraph Input["πŸ“₯ Input β€” Multiple Modes"]
        TXT["πŸ“ Text Requirement"]
        IMG["πŸ–ΌοΈ Image / Wireframe (F3 NEW)"]
    end

    subgraph Frontend["πŸ–₯️ Frontend β€” Premium Dark UI"]
        Page["page.tsx β€” Main Orchestrator UI"]
        PV["PipelineView β€” 8 Agent Cards"]
        HITLM["⏸️ HITLModal (Gap #1)"]
        SP["βš™οΈ SettingsPanel (Gap #2)"]
        ST["🌊 Token Stream Preview (Gap #9)"]
        VU["πŸ–ΌοΈ VisionUploader (F3 NEW)"]
        EAP["πŸ“Š EnhancedAnalyticsPanel (F7 NEW)"]
        WV["WorkspaceViewer"]
        HP["HistoryPanel"]
    end

    subgraph API["πŸ“‘ API Routes"]
        OR["/api/orchestrate β€” SSE Pipeline"]
        HITLA["/api/hitl β€” HITL Decisions"]
        DEL["/api/deliver β€” GitHub Push"]
        VIS["/api/vision β€” Vision-to-Code (F3 NEW)"]
        ANA["/api/analyze β€” Debt + Compliance (F2/F4 NEW)"]
        WS["/api/workspace β€” File Save"]
    end

    subgraph Pipeline["πŸ”„ Orchestration Pipeline v3.1"]
        O["orchestrator.ts"]

        R0["🧭 Router Agent\nclassifyIntent()"]

        subgraph LangDetect["🌍 Language Detection (F5 NEW)"]
            LD["detectLanguage()\ngetSkillPrompt()"]
        end

        subgraph Mem["🧠 Memory (Gap #8)"]
            MEM["memory.ts β€” localStorage prefs"]
        end

        subgraph Rag["πŸ“š RAG"]
            RAG["retrieveRelevantChunks()\nTF-IDF cosine similarity"]
        end

        A1["πŸ” Analyst\n+ Zod validation"]
        A2["πŸ“‹ Planner\n+ Zod validation"]
        A3["πŸ’» Developer\n+ language skill\n+ streamText"]
        A4["πŸ”Ž Code Reviewer\n+ lint tool\n+ Zod validation"]
        HITLG["⏸️ HITL Gate"]
        A5["πŸ›‘οΈ Security Reviewer\n+ OWASP scan"]
        A6["βš–οΈ Compliance Agent\nGDPR/HIPAA/PCI/SOC2 (F4 NEW)"]

        subgraph Parallel["⚑ Parallel Group (Gap #6)"]
            A7["πŸ§ͺ Testing Agent"]
            DS["πŸ—οΈ Debt Scanner (F2 NEW)"]
        end

        A8["πŸš€ Deployment Agent"]

        subgraph ROI["πŸ’° ROI (F7 NEW)"]
            ROIC["roi.ts β€” computeROI()"]
        end
    end

    subgraph Audit["πŸ“‹ Audit Log (Gap #7)"]
        AL["Every event β†’ AuditLog.log()"]
    end

    TXT --> Page
    IMG --> VU --> VIS
    Page --> OR
    OR --> O
    O --> R0 --> LangDetect --> Mem --> Rag
    Rag --> A1 --> A2 --> A3
    LangDetect -->|skill prompt| A3
    A3 --> A4
    A4 -->|CHANGES| A3
    A4 -->|APPROVED| HITLG
    HITLG --> A5 --> A6
    A6 -->|PASS| Parallel
    Parallel --> A8
    A8 --> ROI
    O --> AL
    OR --> HITLA
    OR --> DEL
    OR --> ANA

    style Input fill:#1a1225,color:#e0e0ff
    style Frontend fill:#1a1a2e,color:#e0e0ff
    style API fill:#16213e,color:#e0e0ff
    style Pipeline fill:#0f1e3d,color:#e0e0ff
    style Audit fill:#1e2a1a,color:#e0e0ff
    style ROI fill:#1e2a1a,color:#e0e0ff
    style Parallel fill:#1a2e1a,color:#e0e0ff
    style LangDetect fill:#1a1e2e,color:#e0e0ff
    style Mem fill:#2a1a2e,color:#e0e0ff
    style Rag fill:#1e1a2e,color:#e0e0ff
Loading

πŸš€ Quick Start

Prerequisites

1. Clone & Install

git clone https://github.com/ParthivPandya/multi-agent-orchestrator.git
cd multi-agent-orchestrator/multi-agent-system
npm install

2. Configure

cp .env.example .env.local
# .env.local

# βœ… Required β€” get free key at https://console.groq.com
GROQ_API_KEY=gsk_your_api_key_here

# Optional β€” for additional LLM providers
# OPENAI_API_KEY=sk-...
# ANTHROPIC_API_KEY=sk-ant-...

Tip: OpenAI and Anthropic keys can also be entered in Settings β†’ Providers tab at runtime. They stay in localStorage β€” never sent to any server.

3. Run

npm run dev
# β†’ http://localhost:3000

4. Deploy (One Click)

Deploy with Vercel


πŸ“ Project Structure

multi-agent-system/
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ app/
β”‚   β”‚   β”œβ”€β”€ page.tsx                          # Main UI β€” all 14 features integrated
β”‚   β”‚   β”œβ”€β”€ globals.css                       # Premium glassmorphism dark theme
β”‚   β”‚   └── api/
β”‚   β”‚       β”œβ”€β”€ orchestrate/route.ts          # SSE pipeline β€” all agents
β”‚   β”‚       β”œβ”€β”€ hitl/route.ts                 # HITL decision endpoint
β”‚   β”‚       β”œβ”€β”€ deliver/route.ts              # GitHub MCP push
β”‚   β”‚       β”œβ”€β”€ vision/route.ts               # πŸ†• Vision-to-Code (F3)
β”‚   β”‚       β”œβ”€β”€ analyze/route.ts              # πŸ†• Debt + Compliance on-demand (F2, F4)
β”‚   β”‚       └── workspace/route.ts            # File save/list
β”‚   β”œβ”€β”€ lib/
β”‚   β”‚   β”œβ”€β”€ orchestrator.ts                   # 🎯 v3.1 pipeline controller
β”‚   β”‚   β”œβ”€β”€ hitl.ts                           # HITL promise resolver
β”‚   β”‚   β”œβ”€β”€ audit.ts                          # Audit log recorder
β”‚   β”‚   β”œβ”€β”€ memory.ts                         # Cross-session memory
β”‚   β”‚   β”œβ”€β”€ roi.ts                            # πŸ†• ROI calculator (F7)
β”‚   β”‚   β”œβ”€β”€ agents/
β”‚   β”‚   β”‚   β”œβ”€β”€ routerAgent.ts                # Intent classifier
β”‚   β”‚   β”‚   β”œβ”€β”€ requirementsAnalyst.ts        # Agent 1
β”‚   β”‚   β”‚   β”œβ”€β”€ taskPlanner.ts                # Agent 2
β”‚   β”‚   β”‚   β”œβ”€β”€ developer.ts                  # Agent 3 + streaming + language skills
β”‚   β”‚   β”‚   β”œβ”€β”€ codeReviewer.ts               # Agent 4 + lint
β”‚   β”‚   β”‚   β”œβ”€β”€ securityReviewer.ts           # Agent 5 β€” OWASP
β”‚   β”‚   β”‚   β”œβ”€β”€ testingAgent.ts               # Agent 6 β€” parallel
β”‚   β”‚   β”‚   β”œβ”€β”€ deploymentAgent.ts            # Agent 7
β”‚   β”‚   β”‚   β”œβ”€β”€ debtScanner.ts                # πŸ†• Technical Debt Scanner (F2)
β”‚   β”‚   β”‚   └── complianceAgent.ts            # πŸ†• GDPR/HIPAA/PCI/SOC2 (F4)
β”‚   β”‚   β”œβ”€β”€ skills/
β”‚   β”‚   β”‚   └── languages.ts                  # πŸ†• 7-language skill registry (F5)
β”‚   β”‚   β”œβ”€β”€ providers/index.ts                # Multi-provider LLM factory
β”‚   β”‚   β”œβ”€β”€ providers/runtime.ts              # Runtime provider/model resolver per agent
β”‚   β”‚   β”œβ”€β”€ validation/
β”‚   β”‚   β”‚   β”œβ”€β”€ schemas.ts                    # Zod schemas (Zod v4 compatible)
β”‚   β”‚   β”‚   └── handoff.ts                    # validateHandoff() utility
β”‚   β”‚   β”œβ”€β”€ prompts/                          # System prompts for all agents
β”‚   β”‚   β”œβ”€β”€ tools/                            # searchWeb, lintCode, readFile
β”‚   β”‚   β”œβ”€β”€ rag/                              # TF-IDF knowledge base
β”‚   β”‚   β”œβ”€β”€ flows/types.ts                    # Pipeline flow DSL
β”‚   β”‚   └── workspace/checkpoint.ts           # Save/load/resume
β”‚   └── components/
β”‚       β”œβ”€β”€ RequirementInput.tsx
β”‚       β”œβ”€β”€ PipelineView.tsx                  # 8-agent pipeline view
β”‚       β”œβ”€β”€ AgentCard.tsx                     # Status-aware agent card
β”‚       β”œβ”€β”€ HITLModal.tsx                     # HITL approval modal
β”‚       β”œβ”€β”€ SettingsPanel.tsx                 # Provider/model/delivery/memory settings
β”‚       β”œβ”€β”€ EnterpriseTeamPanel.tsx           # RBAC + team management enterprise panel
β”‚       β”œβ”€β”€ VisualEditor.tsx                  # Drag-and-drop visual DAG workflow builder
β”‚       β”œβ”€β”€ VisionUploader.tsx                # πŸ†• Vision-to-Code uploader (F3)
β”‚       β”œβ”€β”€ EnhancedAnalyticsPanel.tsx        # πŸ†• ROI + Debt + Compliance dashboard (F7)
β”‚       β”œβ”€β”€ OutputPanel.tsx
β”‚       β”œβ”€β”€ WorkspaceViewer.tsx               # File tree + ZIP export
β”‚       β”œβ”€β”€ AnalyticsPanel.tsx
β”‚       └── HistoryPanel.tsx

πŸ“‘ API Reference

POST /api/orchestrate

Main pipeline. Returns Server-Sent Events stream.

// Request
{
  "requirement": "Build a FastAPI REST API for a todo app with JWT auth",
  "hitlEnabled": true,
  "resumeCheckpointId": "optional-for-resume",
  "workflowId": "standard-pipeline",
  "customModels": {
    "developer": { "provider": "openai", "model": "gpt-4o" }
  },
  "apiKeys": {
    "openai": "sk-..."
  },
  "ollamaUrl": "http://localhost:11434"
}

SSE Event Types:

Event Description
route_decision Router classified intent β€” mode, confidence, skipped agents
stage_start / stage_complete / stage_error Agent lifecycle events
stage_token Developer agent streaming token (Gap #9)
hitl_requested Pipeline paused for human approval (Gap #1)
pipeline_blocked Security blocked deployment (Gap #4)
validation_error Zod schema validation warning (Gap #3)
parallel_group_start/complete Parallel execution (Gap #6)
iteration_info Language detection, memory-active context, debt/compliance scan, and dev/review loop info
final_result Complete results + debtReport + complianceReport + detectedLanguage + auditLog

Runtime provider note: customModels, apiKeys, and ollamaUrl are passed through to agent runtime, enabling per-agent provider/model execution.

POST /api/hitl

Submit human decision to resume paused pipeline.

{ "requestId": "hitl_xxx", "decision": "approved", "feedback": "Looks great!" }

Decisions: approved | rejected | changes_requested

POST /api/deliver

Push generated files to GitHub.

{
  "target": "github",
  "config": { "token": "ghp_...", "owner": "you", "repoName": "my-app" },
  "files": [{ "path": "src/index.ts", "content": "..." }]
}

POST /api/vision (Feature 3)

Convert design image to code. Accepts multipart/form-data.

image         File      β€” PNG/JPG/WEBP (required)
framework     string    β€” react|nextjs|vue|svelte|angular|vanilla
language      string    β€” typescript|python|go|java|rust|ruby|php
styleLibrary  string    β€” tailwind|mui|shadcn|chakra|css-modules
context       string    β€” optional extra instructions

POST /api/analyze (Features 2 & 4)

On-demand technical debt + compliance analysis.

{
  "code": "your code here",
  "language": "python",
  "runDebt": true,
  "runCompliance": true,
  "complianceFrameworks": ["GDPR", "HIPAA", "OWASP_TOP10"],
  "industry": "healthcare"
}

πŸ›‘οΈ Resilience & Rate Limiting

Setting Value
Inter-agent delay 1,500ms (prevents Groq rate limits)
Retry attempts per agent 3
Retry backoff 2s β†’ 4s β†’ 8s
Max review iterations 3
HITL timeout 10 minutes (then auto-approved)
Security block level CRITICAL & HIGH only
Compliance block Critical violations only
Debt scan Non-blocking (pipeline continues always)
Vision model Llama 4 Maverick (multimodal)
Router failure Falls back to FULL_PIPELINE
Testing failure Non-fatal β€” pipeline continues

πŸ† Feature Comparison

Capability Matrix (Expanded)

Feature This Project LangFlow Flowise LangGraph CrewAI AutoGen OpenDevin n8n
🎨 Visual Drag-and-Drop Workflow Editor βœ… Enterprise UI βœ… βœ… ⚠️ Code-first ⚠️ Limited ⚠️ Limited ⚠️ Limited βœ…
πŸ”€ Flexible DAG / Branching Workflows βœ… βœ… βœ… βœ… ⚠️ ⚠️ ⚠️ βœ…
⏸️ Human-in-the-Loop Controls βœ… ⚠️ βœ… βœ… ⚠️ ⚠️ ⚠️ ⚠️
πŸ‘₯ Team + RBAC Controls βœ… ⚠️ ⚠️ ⚠️ βœ… ⚠️ ⚠️ βœ…
πŸ”‘ Multi-Provider LLM Runtime βœ… Per-agent βœ… βœ… βœ… βœ… βœ… ⚠️ βœ…
πŸ“Š Observability / Traces / Audit Export βœ… ⚠️ βœ… βœ… ⚠️ ⚠️ ⚠️ βœ…
πŸ”— Connectors + Webhook Triggers βœ… ⚠️ βœ… ⚠️ βœ… ⚠️ ⚠️ βœ…
🧠 Session Memory + Context βœ… ⚠️ βœ… βœ… ⚠️ βœ… ⚠️ ⚠️
πŸ›‘οΈ Security Review Gate (OWASP) βœ… ❌ ❌ ❌ ❌ ❌ ❌ ❌
πŸ§ͺ Built-in Testing Agent Flow βœ… ❌ ❌ ❌ ⚠️ ⚠️ βœ… ❌
πŸ’Ύ Checkpoint + Resume βœ… ⚠️ ⚠️ βœ… ⚠️ ⚠️ ⚠️ βœ…
🌊 Live Token Streaming in UI βœ… ⚠️ βœ… ⚠️ ❌ ⚠️ ⚠️ ❌
πŸ–ΌοΈ Vision-to-Code βœ… ⚠️ ⚠️ ❌ ❌ ❌ ⚠️ ❌

Legend: βœ… Native support Β· ⚠️ Partial / plugin / code-heavy setup Β· ❌ Not a core built-in capability

Competitor Snapshot

Platform Strength Where this repo stands out
LangFlow Great visual flow authoring Adds stronger governance features: RBAC + HITL + security gate + audit export
Flowise Strong low-code orchestration and integrations Adds built-in agent roles, security reviewer, and end-to-end software pipeline focus
LangGraph Robust graph + memory model Adds richer no-code UX and productized pipeline UI for non-framework users
CrewAI Team/task collaboration model Adds visual DAG builder + enterprise telemetry dashboard in one product
AutoGen Flexible agent conversations Adds production UX, visual workflow builder, and governance controls
OpenDevin Execution-centric engineering workflows Adds orchestration governance, routing, and enterprise monitoring controls
n8n Best-in-class automation/connectors Adds specialized AI software-engineering pipeline with reviewer/security/testing agents

πŸ› οΈ Tech Stack

Technology Purpose
Next.js 16 Full-stack React framework (App Router)
TypeScript 5 Type-safe development across all 60+ files
Vercel AI SDK v6 generateText + streamText β€” unified LLM interface
@ai-sdk/groq Groq API provider (default, free)
Zod v4 Schema validation at every agent handoff
Groq Cloud Ultra-fast LLM inference β€” free tier (30 RPM)
TF-IDF (custom) In-memory RAG β€” zero extra dependencies
DuckDuckGo Instant API Free web search for agentic tool calls
GitHub REST API MCP code delivery (no Octokit required)
Llama 4 Maverick Vision model for image-to-code conversion
Vanilla CSS Custom glassmorphism design system + animations

πŸ—ΊοΈ Roadmap

βœ… Shipped

v1 β€” Foundation (6-agent pipeline, streaming UI, workspace)
  • 6-agent automated pipeline with live SSE UI
  • Developer ↔ Reviewer feedback loop (3 iterations)
  • Workspace file manager with ZIP export
  • Premium glassmorphism dark UI
  • Analytics dashboard (tokens, latency, cost)
  • Pipeline history with localStorage persistence
  • Individual agent test API
  • Retry with exponential backoff
v2 β€” Intelligence Layer (routing, tools, RAG, flows, checkpoints)
  • 🧭 Intelligent routing β€” 4-mode classifier
  • βš™οΈ Agentic tools β€” searchWeb, lintCode, readFile
  • πŸ“š RAG knowledge base β€” TF-IDF over Next.js 15, React 19, TS 5 docs
  • πŸ”€ Flows DSL β€” typed pipeline definitions
  • πŸ’Ύ Stateful checkpoints β€” resume from failure
  • πŸ§ͺ Testing Agent β€” auto-generates unit & integration tests
v3 β€” Enterprise Gaps (9 critical features)
  • ⏸️ Human-in-the-Loop (HITL) modal approval gate
  • πŸ”‘ Multi-Provider LLM (Groq + OpenAI + Anthropic + Ollama)
  • βœ… Structured Output Validation (Zod v4 schemas)
  • πŸ›‘οΈ Security Reviewer Agent (OWASP Top 10)
  • πŸ™ MCP GitHub Delivery
  • ⚑ Parallel Agent Execution
  • πŸ“‹ Full Audit Log Export (JSON)
  • 🧠 Agent Memory β€” cross-session learning
  • 🌊 Token Streaming β€” live code preview
Phase 1 β€” Enterprise Power (5 new features, current)
  • 🌍 Multi-Language Pipeline (7 languages with auto-detection)
  • πŸ—οΈ Technical Debt Scanner (A–F grade, 6 categories)
  • βš–οΈ Compliance Agent (GDPR, HIPAA, PCI-DSS, SOC 2, DPDP, OWASP)
  • πŸ–ΌοΈ Vision-to-Code (image β†’ component code with Llama 4 Maverick)
  • πŸ’° ROI Intelligence Dashboard (savings, ROI multiple, sprint impact)

πŸ”­ Coming Next (Phase 2–3)

Feature Phase Impact
πŸ›οΈ Legacy Code Modernizer Phase 2 COBOL/Java 8 β†’ modern stack
πŸ—ΊοΈ Knowledge Graph Builder Phase 2 Semantic codebase map for onboarding
πŸ“‹ Jira / Linear / Azure DevOps Phase 2 AI tasks β†’ PM tickets automatically
πŸ‘₯ Collaborative Multi-User Phase 2 Real-time shared pipeline review
πŸ§ͺ Synthetic Test Data Phase 3 GDPR-safe realistic test datasets
πŸ€– Autonomous CI/CD Agent Phase 3 Trigger β†’ monitor β†’ auto-fix build failures
πŸͺ Template Marketplace Phase 3 Community starters, 40% faster runs
πŸ“± Mobile-Responsive UI Phase 3 Full mobile support

🀝 Contributing

Contributions are what make this the best repo on GitHub. Every PR is reviewed with care.

How to Contribute

# 1. Fork the repository
# 2. Create your feature branch
git checkout -b feature/amazing-feature

# 3. Make your changes
# 4. Run TypeScript check
npx tsc --noEmit --skipLibCheck

# 5. Commit
git commit -m 'feat: add amazing feature'

# 6. Push
git push origin feature/amazing-feature

# 7. Open a Pull Request

Good First Issues

Task Difficulty Where to Look
Add more RAG knowledge chunks 🟒 Easy src/lib/rag/knowledgeBase.ts
Add a new language skill 🟒 Easy src/lib/skills/languages.ts
Add a Jira delivery target 🟑 Medium src/app/api/deliver/route.ts
Add email HITL notifications 🟑 Medium src/lib/hitl.ts
Build the Legacy Modernizer Agent πŸ”΄ Hard src/lib/agents/
Real vector DB (pgvector) for RAG πŸ”΄ Hard src/lib/rag/

πŸ’‘ Pro tip: Each new feature is self-contained in its own module. Adding a new agent takes ~150 lines. Adding a new delivery target takes ~50 lines.


πŸ“„ License

MIT License β€” see LICENSE for full details. Use it, fork it, ship it.


⭐ Star This Repository

If this project gave you value, taught you something, or just impressed you β€” drop a star. It helps more developers discover the best open-source AI orchestrator on GitHub.

Star History Chart


Built with ❀️ and extraordinary ambition by Parthiv Pandya

Next.js Β· TypeScript Β· Groq Β· Vercel AI SDK Β· Zod Β· RAG Β· HITL Β· MCP Β· Streaming Β· Multi-Language Β· Vision Β· Compliance Β· ROI

GitHub Email


⬆ Back to Top

v3.1 Β· March 2026 Β· 14 Enterprise Features Β· 8 Agents Β· 7 Languages Β· 100% Free