# 1nsharma-labs/universal-engineering-os architecture

> Architecture diagram of the GitHub repository 1nsharma-labs/universal-engineering-os, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/1nsharma-labs/universal-engineering-os
- Repository: https://github.com/1nsharma-labs/universal-engineering-os

## Overview

UNIFORGE is a polyglot engineering platform centered on a Control Plane API and Operational Studio. Users can request architecture or project unification, run autonomous builds and RAG queries, operate studio tools, and plan or approve deployment. The factory has distinct knowledge/model selection, architecture resolution, worker assembly, quality and human-approval gates, and distribution stages. The README also documents templates, integrations, plugins, marketplace, cloud, and operational ecosystem capabilities. Service internals are mostly unsampled; edges below rely on the API excerpt, factory excerpt, or README rather than assumptions about those internals.

Main entry points: [`00-universal-control-plane/orchestrator-api/main.py`](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/main.py) (Control Plane API), [`00-universal-control-plane/orchestrator-api/software_factory_service.py`](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/software_factory_service.py) (Software Factory), [`00-universal-control-plane/orchestrator-api/rag_brain_service.py`](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/rag_brain_service.py) (Local RAG Brain), [`00-universal-control-plane/orchestrator-api/brain.py`](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/brain.py) (AI Architect)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Control Plane"]
  node_api["Control Plane API<br/>[main.py]"]
  node_brain["AI Architect<br/>[brain.py]"]
  node_unifier["Project Unifier<br/>[project_unifier.py]"]
  node_sandbox["Code Sandbox<br/>[sandbox_runner.py]"]
end

subgraph group_factory["Build And Deploy"]
  node_team["Autonomous Team"]
  node_factorysvc["Software Factory"]
  node_deploy["Deploy Planner"]
end

subgraph group_studio["Operational Studio"]
  node_api_studio["API Studio"]
  node_lsp["Monaco LSP<br/>[lsp_service.py]"]
  node_terminal["PTY Terminal"]
  node_canvas["Visual Canvas"]
  node_studio_services["Studio Services<br/>[studio_services.py]"]
end

subgraph group_ecosystem["Engineering Ecosystem"]
  node_rag["Local RAG Brain"]
  node_registry["Tech Registry<br/>[core_os_layer.py]"]
  node_models["AI Models"]
  node_datasets["Open Datasets"]
  node_connectors["Unified Connectors"]
  node_frameworks["Framework Starters"]
  node_workflows["Automation Workflows"]
end

subgraph group_platform["Extensions And Cloud"]
  node_plugins["Plugin SDK And Plugins"]
  node_marketplace["Plugin Marketplace"]
  node_cloud["UNIFORGE Cloud"]
  node_mcp["MCP Servers"]
end

node_engineer(("Engineer"))

node_engineer -.->|"requests work"| node_api
node_api -->|"routes architect"| node_brain
node_api -->|"routes unify"| node_unifier
node_api -->|"routes execution"| node_sandbox
node_api -.->|"routes factory"| node_factorysvc
node_factorysvc -->|"queries context"| node_rag
node_factorysvc -->|"resolves architecture"| node_brain
node_factorysvc -->|"runs build"| node_team
node_factorysvc -->|"plans distribution"| node_deploy
node_factorysvc -.->|"selects models"| node_models
node_factorysvc -.->|"selects datasets"| node_datasets
node_api -->|"routes queries"| node_rag
node_api -->|"routes requests"| node_api_studio
node_api -->|"routes diagnostics"| node_lsp
node_api -->|"routes commands"| node_terminal
node_api -->|"routes compilation"| node_canvas
node_api -.->|"routes studio tools"| node_studio_services
node_api -.->|"serves registry"| node_registry
node_api -.->|"exposes plugins"| node_plugins
node_api -.->|"exposes marketplace"| node_marketplace
node_api -.->|"controls workspace"| node_cloud
node_frameworks -.->|"integrates services"| node_connectors
node_workflows -.->|"syncs knowledge"| node_rag
node_api -.->|"uses tool hub"| node_mcp

click node_api "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/main.py"
click node_brain "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/brain.py"
click node_unifier "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/project_unifier.py"
click node_sandbox "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/sandbox_runner.py"
click node_team "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/autonomous_team_service.py"
click node_factorysvc "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/software_factory_service.py"
click node_deploy "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/deploy_hub_service.py"
click node_rag "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/rag_brain_service.py"
click node_registry "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/core_os_layer.py"
click node_models "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/03-ai-models-and-inference"
click node_datasets "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/06-open-source-datasets"
click node_connectors "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/04-connectors-and-apis/unified-connectors.py"
click node_frameworks "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/02-frameworks-and-templates"
click node_workflows "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/10-automation-and-workflows"
click node_api_studio "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/api_studio_service.py"
click node_lsp "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/lsp_service.py"
click node_terminal "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/terminal_service.py"
click node_canvas "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/visual_canvas_service.py"
click node_studio_services "https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/studio_services.py"
click node_plugins "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/packages/plugin-sdk"
click node_marketplace "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/marketplace"
click node_cloud "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/cloud"
click node_mcp "https://github.com/1nsharma-labs/universal-engineering-os/tree/main/05-mcp-servers-hub"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_api,node_brain,node_unifier,node_sandbox toneBlue
class node_team,node_factorysvc,node_deploy toneAmber
class node_api_studio,node_lsp,node_terminal,node_canvas,node_studio_services toneMint
class node_rag,node_registry,node_models,node_datasets,node_connectors,node_frameworks,node_workflows toneRose
class node_plugins,node_marketplace,node_cloud,node_mcp,node_engineer toneIndigo
```

## Components

### Control Plane

- [Control Plane API](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/main.py): `00-universal-control-plane/orchestrator-api/main.py`
- [AI Architect](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/brain.py): `00-universal-control-plane/orchestrator-api/brain.py`
- [Project Unifier](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/project_unifier.py): `00-universal-control-plane/orchestrator-api/project_unifier.py`
- [Code Sandbox](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/sandbox_runner.py): `00-universal-control-plane/orchestrator-api/sandbox_runner.py`

### Build And Deploy

- [Autonomous Team](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/autonomous_team_service.py): `00-universal-control-plane/orchestrator-api/autonomous_team_service.py`
- [Software Factory](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/software_factory_service.py): `00-universal-control-plane/orchestrator-api/software_factory_service.py`
- [Deploy Planner](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/deploy_hub_service.py): `00-universal-control-plane/orchestrator-api/deploy_hub_service.py`

### Operational Studio

- [API Studio](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/api_studio_service.py): `00-universal-control-plane/orchestrator-api/api_studio_service.py`
- [Monaco LSP](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/lsp_service.py): `00-universal-control-plane/orchestrator-api/lsp_service.py`
- [PTY Terminal](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/terminal_service.py): `00-universal-control-plane/orchestrator-api/terminal_service.py`
- [Visual Canvas](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/visual_canvas_service.py): `00-universal-control-plane/orchestrator-api/visual_canvas_service.py`
- [Studio Services](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/studio_services.py): `00-universal-control-plane/orchestrator-api/studio_services.py`

### Engineering Ecosystem

- [Local RAG Brain](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/rag_brain_service.py): `00-universal-control-plane/orchestrator-api/rag_brain_service.py`
- [Tech Registry](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/00-universal-control-plane/orchestrator-api/core_os_layer.py): `00-universal-control-plane/orchestrator-api/core_os_layer.py`
- [AI Models](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/03-ai-models-and-inference): `03-ai-models-and-inference`
- [Open Datasets](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/06-open-source-datasets): `06-open-source-datasets`
- [Unified Connectors](https://github.com/1nsharma-labs/universal-engineering-os/blob/main/04-connectors-and-apis/unified-connectors.py): `04-connectors-and-apis/unified-connectors.py`
- [Framework Starters](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/02-frameworks-and-templates): `02-frameworks-and-templates`
- [Automation Workflows](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/10-automation-and-workflows): `10-automation-and-workflows`

### Extensions And Cloud

- [Plugin SDK And Plugins](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/packages/plugin-sdk): `packages/plugin-sdk`
- [Plugin Marketplace](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/marketplace): `marketplace`
- [UNIFORGE Cloud](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/cloud): `cloud`
- [MCP Servers](https://github.com/1nsharma-labs/universal-engineering-os/tree/main/05-mcp-servers-hub): `05-mcp-servers-hub`

### Other components

- **Engineer**

## Connections

- Engineer → Control Plane API: requests work (evidence: `README.md`)
- Control Plane API → AI Architect: routes architect (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Project Unifier: routes unify (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Code Sandbox: routes execution (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Software Factory: routes factory (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Software Factory → Local RAG Brain: queries context (evidence: `00-universal-control-plane/orchestrator-api/software_factory_service.py`)
- Software Factory → AI Architect: resolves architecture (evidence: `00-universal-control-plane/orchestrator-api/software_factory_service.py`)
- Software Factory → Autonomous Team: runs build (evidence: `00-universal-control-plane/orchestrator-api/software_factory_service.py`)
- Software Factory → Deploy Planner: plans distribution (evidence: `00-universal-control-plane/orchestrator-api/software_factory_service.py`)
- Software Factory → AI Models: selects models
- Software Factory → Open Datasets: selects datasets
- Control Plane API → Local RAG Brain: routes queries (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → API Studio: routes requests (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Monaco LSP: routes diagnostics (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → PTY Terminal: routes commands (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Visual Canvas: routes compilation (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Studio Services: routes studio tools (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Tech Registry: serves registry (evidence: `00-universal-control-plane/orchestrator-api/main.py`)
- Control Plane API → Plugin SDK And Plugins: exposes plugins (evidence: `README.md`)
- Control Plane API → Plugin Marketplace: exposes marketplace (evidence: `README.md`)
- Control Plane API → UNIFORGE Cloud: controls workspace (evidence: `README.md`)
- Framework Starters → Unified Connectors: integrates services (evidence: `README.md`)
- Automation Workflows → Local RAG Brain: syncs knowledge
- Control Plane API → MCP Servers: uses tool hub (evidence: `README.md`)
