# coreemu/core architecture

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

- Interactive diagram: https://gitdiagram.com/coreemu/core
- Repository: https://github.com/coreemu/core

## Overview

CORE is a network emulator for building and running virtual network topologies, locally or across machines, with optional connections to live networks. The principal workflow is to design or script a topology, create a session, instantiate nodes and links, configure mobility, services and wireless/EMANE behavior, then run and observe the emulation. The daemon exposes gRPC control used by the GUI and other clients. The tree and README establish the major capabilities; several subsystem links below are documented at product level because their implementation was not sampled.

Main entry points: [`daemon/core/emulator/session.py`](https://github.com/coreemu/core/blob/master/daemon/core/emulator/session.py) (Session Manager), [`daemon/core/nodes/base.py`](https://github.com/coreemu/core/blob/master/daemon/core/nodes/base.py) (Node Runtime), [`daemon/core/gui/app.py`](https://github.com/coreemu/core/blob/master/daemon/core/gui/app.py) (Topology GUI), [`daemon/core/api/grpc/server.py`](https://github.com/coreemu/core/blob/master/daemon/core/api/grpc/server.py) (gRPC API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_design["Topology Design"]
  node_gui["Topology GUI<br/>[app.py]"]
  node_canvas["Canvas Editor<br/>[manager.py]"]
  node_client["GUI Client<br/>[coreclient.py]"]
end

subgraph group_control["Session Control"]
  node_api["gRPC API<br/>[server.py]"]
  node_session["Session Manager<br/>[session.py]"]
  node_data["Emulation Data<br/>[data.py]"]
  node_distributed["Distributed Hosts<br/>[distributed.py]"]
end

subgraph group_runtime["Network Runtime"]
  node_node["Node Runtime<br/>[base.py]"]
  node_interfaces["Network Interfaces<br/>[interface.py]"]
  node_netclient["Linux Network Commands<br/>[netclient.py]"]
  node_network["Network Nodes<br/>[network.py]"]
  node_netns["Linux Namespaces<br/>[vnoded_main.c]"]
end

subgraph group_wireless["Wireless Emulation"]
  node_wirelessnodes["Wireless Nodes<br/>[wireless.py]"]
  node_mobility["Mobility Models<br/>[mobility.py]"]
  node_emane["EMANE Manager<br/>[emanemanager.py]"]
  node_emanenodes["EMANE Nodes<br/>[nodes.py]"]
  node_models["EMANE Models<br/>[emanemodel.py]"]
end

subgraph group_operations["Services And Integration"]
  node_services["Node Services<br/>[base.py]"]
  node_service_registry["Service Registry<br/>[manager.py]"]
  node_xml["Topology XML<br/>[corexml.py]"]
  node_live(("Live Networks"))
end

node_user(("Operator / Script"))

node_user -->|"designs topology"| node_gui
node_user -->|"scripts emulation"| node_session
node_gui -->|"edits topology"| node_canvas
node_gui -->|"sets up client"| node_client
node_client -.->|"sends control"| node_api
node_api -->|"controls sessions"| node_session
node_session -->|"uses data objects"| node_data
node_session -->|"creates nodes"| node_node
node_session -->|"manages links"| node_network
node_session -->|"selects host"| node_distributed
node_node -->|"creates interfaces"| node_interfaces
node_interfaces -->|"runs commands"| node_netclient
node_node -->|"constructs client"| node_netclient
node_node -->|"starts namespace"| node_netns
node_session -->|"creates WLAN nodes"| node_wirelessnodes
node_session -->|"configures mobility"| node_mobility
node_session -->|"manages EMANE"| node_emane
node_emane -->|"registers networks"| node_emanenodes
node_emanenodes -->|"sets model"| node_models
node_session -.->|"manages services"| node_services
node_service_registry -->|"loads services"| node_services
node_api -->|"exposes XML operations"| node_xml
node_user -.->|"imports or exports"| node_xml
node_user -->|"connects emulation"| node_live

click node_gui "https://github.com/coreemu/core/blob/master/daemon/core/gui/app.py"
click node_canvas "https://github.com/coreemu/core/blob/master/daemon/core/gui/graph/manager.py"
click node_client "https://github.com/coreemu/core/blob/master/daemon/core/gui/coreclient.py"
click node_api "https://github.com/coreemu/core/blob/master/daemon/core/api/grpc/server.py"
click node_session "https://github.com/coreemu/core/blob/master/daemon/core/emulator/session.py"
click node_data "https://github.com/coreemu/core/blob/master/daemon/core/emulator/data.py"
click node_distributed "https://github.com/coreemu/core/blob/master/daemon/core/emulator/distributed.py"
click node_node "https://github.com/coreemu/core/blob/master/daemon/core/nodes/base.py"
click node_interfaces "https://github.com/coreemu/core/blob/master/daemon/core/nodes/interface.py"
click node_netclient "https://github.com/coreemu/core/blob/master/daemon/core/nodes/netclient.py"
click node_network "https://github.com/coreemu/core/blob/master/daemon/core/nodes/network.py"
click node_wirelessnodes "https://github.com/coreemu/core/blob/master/daemon/core/nodes/wireless.py"
click node_mobility "https://github.com/coreemu/core/blob/master/daemon/core/location/mobility.py"
click node_emane "https://github.com/coreemu/core/blob/master/daemon/core/emane/emanemanager.py"
click node_emanenodes "https://github.com/coreemu/core/blob/master/daemon/core/emane/nodes.py"
click node_models "https://github.com/coreemu/core/blob/master/daemon/core/emane/emanemodel.py"
click node_services "https://github.com/coreemu/core/blob/master/daemon/core/services/base.py"
click node_service_registry "https://github.com/coreemu/core/blob/master/daemon/core/services/manager.py"
click node_xml "https://github.com/coreemu/core/blob/master/daemon/core/xml/corexml.py"
click node_netns "https://github.com/coreemu/core/blob/master/netns/vnoded_main.c"

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_gui,node_canvas,node_client toneBlue
class node_api,node_session,node_data,node_distributed toneAmber
class node_node,node_interfaces,node_netclient,node_network,node_netns toneMint
class node_wirelessnodes,node_mobility,node_emane,node_emanenodes,node_models toneRose
class node_services,node_service_registry,node_xml,node_live,node_user toneIndigo
```

## Components

### Topology Design

- [Topology GUI](https://github.com/coreemu/core/blob/master/daemon/core/gui/app.py): `daemon/core/gui/app.py`
- [Canvas Editor](https://github.com/coreemu/core/blob/master/daemon/core/gui/graph/manager.py): `daemon/core/gui/graph/manager.py`
- [GUI Client](https://github.com/coreemu/core/blob/master/daemon/core/gui/coreclient.py): `daemon/core/gui/coreclient.py`

### Session Control

- [gRPC API](https://github.com/coreemu/core/blob/master/daemon/core/api/grpc/server.py): `daemon/core/api/grpc/server.py`
- [Session Manager](https://github.com/coreemu/core/blob/master/daemon/core/emulator/session.py): `daemon/core/emulator/session.py`
- [Emulation Data](https://github.com/coreemu/core/blob/master/daemon/core/emulator/data.py): `daemon/core/emulator/data.py`
- [Distributed Hosts](https://github.com/coreemu/core/blob/master/daemon/core/emulator/distributed.py): `daemon/core/emulator/distributed.py`

### Network Runtime

- [Node Runtime](https://github.com/coreemu/core/blob/master/daemon/core/nodes/base.py): `daemon/core/nodes/base.py`
- [Network Interfaces](https://github.com/coreemu/core/blob/master/daemon/core/nodes/interface.py): `daemon/core/nodes/interface.py`
- [Linux Network Commands](https://github.com/coreemu/core/blob/master/daemon/core/nodes/netclient.py): `daemon/core/nodes/netclient.py`
- [Network Nodes](https://github.com/coreemu/core/blob/master/daemon/core/nodes/network.py): `daemon/core/nodes/network.py`
- [Linux Namespaces](https://github.com/coreemu/core/blob/master/netns/vnoded_main.c): `netns/vnoded_main.c`

### Wireless Emulation

- [Wireless Nodes](https://github.com/coreemu/core/blob/master/daemon/core/nodes/wireless.py): `daemon/core/nodes/wireless.py`
- [Mobility Models](https://github.com/coreemu/core/blob/master/daemon/core/location/mobility.py): `daemon/core/location/mobility.py`
- [EMANE Manager](https://github.com/coreemu/core/blob/master/daemon/core/emane/emanemanager.py): `daemon/core/emane/emanemanager.py`
- [EMANE Nodes](https://github.com/coreemu/core/blob/master/daemon/core/emane/nodes.py): `daemon/core/emane/nodes.py`
- [EMANE Models](https://github.com/coreemu/core/blob/master/daemon/core/emane/emanemodel.py): `daemon/core/emane/emanemodel.py`

### Services And Integration

- [Node Services](https://github.com/coreemu/core/blob/master/daemon/core/services/base.py): `daemon/core/services/base.py`
- [Service Registry](https://github.com/coreemu/core/blob/master/daemon/core/services/manager.py): `daemon/core/services/manager.py`
- [Topology XML](https://github.com/coreemu/core/blob/master/daemon/core/xml/corexml.py): `daemon/core/xml/corexml.py`
- **Live Networks**

### Other components

- **Operator / Script**

## Connections

- Operator / Script → Topology GUI: designs topology
- Operator / Script → Session Manager: scripts emulation
- Topology GUI → Canvas Editor: edits topology (evidence: `daemon/core/gui/app.py`)
- Topology GUI → GUI Client: sets up client (evidence: `daemon/core/gui/app.py`)
- GUI Client → gRPC API: sends control
- gRPC API → Session Manager: controls sessions (evidence: `daemon/core/api/grpc/server.py`)
- Session Manager → Emulation Data: uses data objects (evidence: `daemon/core/emulator/session.py`)
- Session Manager → Node Runtime: creates nodes (evidence: `daemon/core/emulator/session.py`)
- Session Manager → Network Nodes: manages links (evidence: `daemon/core/emulator/session.py`)
- Session Manager → Distributed Hosts: selects host (evidence: `daemon/core/emulator/session.py`)
- Node Runtime → Network Interfaces: creates interfaces (evidence: `daemon/core/nodes/base.py`)
- Network Interfaces → Linux Network Commands: runs commands (evidence: `daemon/core/nodes/interface.py`)
- Node Runtime → Linux Network Commands: constructs client (evidence: `daemon/core/nodes/base.py`)
- Node Runtime → Linux Namespaces: starts namespace (evidence: `daemon/core/nodes/base.py`)
- Session Manager → Wireless Nodes: creates WLAN nodes (evidence: `daemon/core/emulator/session.py`)
- Session Manager → Mobility Models: configures mobility (evidence: `daemon/core/emulator/session.py`)
- Session Manager → EMANE Manager: manages EMANE (evidence: `daemon/core/emulator/session.py`)
- EMANE Manager → EMANE Nodes: registers networks (evidence: `daemon/core/emane/emanemanager.py`)
- EMANE Nodes → EMANE Models: sets model (evidence: `daemon/core/emane/nodes.py`)
- Session Manager → Node Services: manages services
- Service Registry → Node Services: loads services (evidence: `daemon/core/services/manager.py`)
- gRPC API → Topology XML: exposes XML operations (evidence: `daemon/core/api/grpc/server.py`)
- Operator / Script → Topology XML: imports or exports
- Operator / Script → Live Networks: connects emulation
