# sergiopalomba05-jpg/quantumhive architecture

> Architecture diagram of the GitHub repository sergiopalomba05-jpg/quantumhive, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-16). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sergiopalomba05-jpg/quantumhive
- Repository: https://github.com/sergiopalomba05-jpg/quantumhive

## Overview

The tree describes a multi-product repository rather than a single application: it includes Quantum orchestration interfaces and runtime modules, a communications platform, and real-time avatar products. The clearest workflow is using the Quantum web console to reach an orchestration feature; the sampled app excerpt documents its route dispatch, while sampled worker code shows provider selection and generation. The README only names the repository, and most subsystems were not sampled, so their internal connections are not asserted.

Main entry points: [`ORQUESTADOR QUANTUM/src/App.tsx`](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/App.tsx) (Quantum Router), [`HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/App.tsx) (Communications App), [`humania/backend/avatar_pipeline.py`](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/avatar_pipeline.py) (Avatar Pipeline), [`ORQUESTADOR QUANTUM/QUANTUMCORE/src/core/workerManager.ts`](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/workerManager.ts) (Worker Manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Quantum Console"]
  node_qapp["Quantum Router<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_chat["Chat Central<br/>[ChatCentral.tsx]"]
  node_liveassistant["Live Assistant<br/>[LiveAssistant.tsx]"]
  node_agentbuilder["Agent Builder<br/>[AgentBuilder.tsx]"]
  node_promptstudio["Prompt Studio<br/>[PromptStudio.tsx]"]
  node_videoinbox["Video Inbox<br/>[VideoInbox.tsx]"]
  node_integrations["Workspace Integrations"]
end

subgraph group_runtime["Quantum Runtime"]
  node_worker["Worker Manager<br/>[workerManager.ts]"]
  node_providers["Provider Clients<br/>[providerClients.ts]"]
  node_providerrouter["Provider Router<br/>[providerRouter.ts]"]
  node_skills["Skill Manager<br/>[skillManager.ts]"]
  node_quantumserver["Quantum Server<br/>[server.ts]"]
end

subgraph group_comms["Communications"]
  node_commsapp["Communications App<br/>[App.tsx]"]
  node_calendar["Calendar Hub<br/>[CalendarHub.tsx]"]
  node_classroom["Classroom Hub<br/>[ClassroomHub.tsx]"]
  node_gmail["Gmail Hub<br/>[GmailHub.tsx]"]
  node_translations["Translation Hub<br/>[TranslationHub.tsx]"]
  node_tour["Interactive Tour"]
  node_vmconfig["VM Configurator<br/>[VmConfigurator.tsx]"]
end

subgraph group_avatar["Avatar Products"]
  node_avatarapp["Avatar Experience<br/>[App.tsx]"]
  node_avatarpipeline["Avatar Pipeline<br/>[avatar_pipeline.py]"]
  node_liveportrait["LivePortrait Engine"]
  node_musetalk["MuseTalk Engine<br/>[musetalk_engine.py]"]
end

subgraph group_ordering["Ordering Products"]
  node_menuapp["Avatar Menu App<br/>[App.tsx]"]
  node_menudata["Menu Data<br/>[menuData.ts]"]
end

node_user(("Operator"))

node_user -->|"uses"| node_qapp
node_qapp -->|"routes to"| node_dashboard
node_qapp -->|"routes to"| node_chat
node_qapp -->|"routes to"| node_liveassistant
node_qapp -->|"routes to"| node_agentbuilder
node_qapp -->|"routes to"| node_promptstudio
node_qapp -->|"routes to"| node_videoinbox
node_qapp -->|"routes to"| node_integrations
node_worker -->|"selects provider"| node_providerrouter
node_worker -->|"generates with"| node_providers
node_quantumserver -.->|"serves requests"| node_user
node_commsapp -->|"renders"| node_calendar
node_commsapp -->|"renders"| node_classroom
node_commsapp -->|"renders"| node_gmail
node_commsapp -->|"renders"| node_translations
node_commsapp -->|"renders"| node_tour
node_commsapp -->|"renders"| node_vmconfig
node_avatarapp -.->|"streams through"| node_avatarpipeline
node_avatarpipeline -->|"animates with"| node_liveportrait
node_avatarpipeline -->|"lip-syncs with"| node_musetalk
node_menuapp -->|"uses"| node_menudata

click node_qapp "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/App.tsx"
click node_dashboard "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/Dashboard.tsx"
click node_chat "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/ChatCentral.tsx"
click node_liveassistant "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/LiveAssistant.tsx"
click node_agentbuilder "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/AgentBuilder.tsx"
click node_promptstudio "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/PromptStudio.tsx"
click node_videoinbox "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/VideoInbox.tsx"
click node_integrations "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/WorkspaceIntegrations.tsx"
click node_worker "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/workerManager.ts"
click node_providers "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/providerClients.ts"
click node_providerrouter "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/providerRouter.ts"
click node_skills "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/runner/skillManager.ts"
click node_quantumserver "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/server.ts"
click node_commsapp "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/App.tsx"
click node_calendar "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/CalendarHub.tsx"
click node_classroom "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/ClassroomHub.tsx"
click node_gmail "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/GmailHub.tsx"
click node_translations "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/TranslationHub.tsx"
click node_tour "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/InteractiveTour.tsx"
click node_vmconfig "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/VmConfigurator.tsx"
click node_avatarapp "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/frontend/src/App.tsx"
click node_avatarpipeline "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/avatar_pipeline.py"
click node_liveportrait "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/liveportrait_engine.py"
click node_musetalk "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/musetalk_engine.py"
click node_menuapp "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/agencia/motor%20madre/motor-avatares-video-test/src/App.tsx"
click node_menudata "https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/agencia/motor%20madre/motor-avatares-video-test/src/menuData.ts"

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_qapp,node_dashboard,node_chat,node_liveassistant,node_agentbuilder,node_promptstudio,node_videoinbox,node_integrations toneBlue
class node_worker,node_providers,node_providerrouter,node_skills,node_quantumserver toneAmber
class node_commsapp,node_calendar,node_classroom,node_gmail,node_translations,node_tour,node_vmconfig toneMint
class node_avatarapp,node_avatarpipeline,node_liveportrait,node_musetalk toneRose
class node_menuapp,node_menudata,node_user toneIndigo
```

## Components

### Quantum Console

- [Quantum Router](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/App.tsx): `ORQUESTADOR QUANTUM/src/App.tsx`
- [Dashboard](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/Dashboard.tsx): `ORQUESTADOR QUANTUM/src/pages/Dashboard.tsx`
- [Chat Central](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/ChatCentral.tsx): `ORQUESTADOR QUANTUM/src/pages/ChatCentral.tsx`
- [Live Assistant](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/LiveAssistant.tsx): `ORQUESTADOR QUANTUM/src/pages/LiveAssistant.tsx`
- [Agent Builder](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/AgentBuilder.tsx): `ORQUESTADOR QUANTUM/src/pages/AgentBuilder.tsx`
- [Prompt Studio](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/PromptStudio.tsx): `ORQUESTADOR QUANTUM/src/pages/PromptStudio.tsx`
- [Video Inbox](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/VideoInbox.tsx): `ORQUESTADOR QUANTUM/src/pages/VideoInbox.tsx`
- [Workspace Integrations](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/src/pages/WorkspaceIntegrations.tsx): `ORQUESTADOR QUANTUM/src/pages/WorkspaceIntegrations.tsx`

### Quantum Runtime

- [Worker Manager](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/workerManager.ts): `ORQUESTADOR QUANTUM/QUANTUMCORE/src/core/workerManager.ts`
- [Provider Clients](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/providerClients.ts): `ORQUESTADOR QUANTUM/QUANTUMCORE/src/core/providerClients.ts`
- [Provider Router](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/core/providerRouter.ts): `ORQUESTADOR QUANTUM/QUANTUMCORE/src/core/providerRouter.ts`
- [Skill Manager](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/QUANTUMCORE/src/runner/skillManager.ts): `ORQUESTADOR QUANTUM/QUANTUMCORE/src/runner/skillManager.ts`
- [Quantum Server](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/ORQUESTADOR%20QUANTUM/server.ts): `ORQUESTADOR QUANTUM/server.ts`

### Communications

- [Communications App](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/App.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`
- [Calendar Hub](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/CalendarHub.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/components/CalendarHub.tsx`
- [Classroom Hub](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/ClassroomHub.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/components/ClassroomHub.tsx`
- [Gmail Hub](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/GmailHub.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/components/GmailHub.tsx`
- [Translation Hub](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/TranslationHub.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/components/TranslationHub.tsx`
- [Interactive Tour](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/InteractiveTour.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/components/InteractiveTour.tsx`
- [VM Configurator](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/HUMANIA%20PLATAFORMA%20COMUNICACIONES/src/components/VmConfigurator.tsx): `HUMANIA PLATAFORMA COMUNICACIONES/src/components/VmConfigurator.tsx`

### Avatar Products

- [Avatar Experience](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/frontend/src/App.tsx): `humania/frontend/src/App.tsx`
- [Avatar Pipeline](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/avatar_pipeline.py): `humania/backend/avatar_pipeline.py`
- [LivePortrait Engine](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/liveportrait_engine.py): `humania/backend/liveportrait_engine.py`
- [MuseTalk Engine](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/humania/backend/musetalk_engine.py): `humania/backend/musetalk_engine.py`

### Ordering Products

- [Avatar Menu App](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/agencia/motor%20madre/motor-avatares-video-test/src/App.tsx): `agencia/motor madre/motor-avatares-video-test/src/App.tsx`
- [Menu Data](https://github.com/sergiopalomba05-jpg/quantumhive/blob/main/agencia/motor%20madre/motor-avatares-video-test/src/menuData.ts): `agencia/motor madre/motor-avatares-video-test/src/menuData.ts`

### Other components

- **Operator**

## Connections

- Operator → Quantum Router: uses (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Dashboard: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Chat Central: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Live Assistant: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Agent Builder: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Prompt Studio: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Video Inbox: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Quantum Router → Workspace Integrations: routes to (evidence: `ORQUESTADOR QUANTUM/src/App.tsx`)
- Worker Manager → Provider Router: selects provider (evidence: `ORQUESTADOR QUANTUM/QUANTUMCORE/src/core/workerManager.ts`)
- Worker Manager → Provider Clients: generates with (evidence: `ORQUESTADOR QUANTUM/QUANTUMCORE/src/core/workerManager.ts`)
- Quantum Server → Operator: serves requests
- Communications App → Calendar Hub: renders (evidence: `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`)
- Communications App → Classroom Hub: renders (evidence: `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`)
- Communications App → Gmail Hub: renders (evidence: `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`)
- Communications App → Translation Hub: renders (evidence: `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`)
- Communications App → Interactive Tour: renders (evidence: `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`)
- Communications App → VM Configurator: renders (evidence: `HUMANIA PLATAFORMA COMUNICACIONES/src/App.tsx`)
- Avatar Experience → Avatar Pipeline: streams through
- Avatar Pipeline → LivePortrait Engine: animates with (evidence: `humania/backend/avatar_pipeline.py`)
- Avatar Pipeline → MuseTalk Engine: lip-syncs with (evidence: `humania/backend/avatar_pipeline.py`)
- Avatar Menu App → Menu Data: uses (evidence: `agencia/motor madre/motor-avatares-video-test/src/App.tsx`)
