# aliraza0337/libra architecture

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

- Interactive diagram: https://gitdiagram.com/aliraza0337/libra
- Repository: https://github.com/aliraza0337/libra
- Video tour (about a minute): https://gitdiagram.com/aliraza0337/libra/video

## Overview

LIBRA models request handling across virtual machines and serverless functions, with a trace-driven simulator as its documented entry point. Each epoch generates requests, passes them to a policy manager, and routes them to the configured compute model; the simulator drains queued VM work and calculates costs. A separate AWS experiment runner sends real requests and manages AWS infrastructure. The excerpts establish the local simulation flow and parts of AWS dispatch and scaling; some AWS subsystem details are unsampled, so those links are omitted where evidence is insufficient.

Main entry points: [`aws/run_experiment.py`](https://github.com/aliraza0337/libra/blob/main/aws/run_experiment.py) (AWS Runner), [`simulator.py`](https://github.com/aliraza0337/libra/blob/main/simulator.py) (Simulator), [`aws/manager.py`](https://github.com/aliraza0337/libra/blob/main/aws/manager.py) (AWS Manager), [`aws/req_utils.py`](https://github.com/aliraza0337/libra/blob/main/aws/req_utils.py) (Request Dispatch)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation"]
  node_simulator["Simulator<br/>[simulator.py]"]
  node_config["Simulation Config<br/>[configuration.py]"]
  node_traffic["Trace Traffic"]
  node_traces["Workload Traces"]
end

subgraph group_policy["Hybrid Policy"]
  node_manager["Policy Manager<br/>[manager.py]"]
end

subgraph group_compute["Compute Models"]
  node_vm["VM Cloud<br/>[vm_cloud.py]"]
  node_vm_instance["VM Instance<br/>[vm_cloud.py]"]
  node_serverless["Serverless Model"]
end

subgraph group_aws["AWS Experiment"]
  node_aws_runner["AWS Runner<br/>[run_experiment.py]"]
  node_aws_config["AWS Config<br/>[configuration.py]"]
  node_aws_traffic["AWS Traffic"]
  node_aws_manager["AWS Manager<br/>[manager.py]"]
  node_aws_vm_utils["VM Scaling Utilities<br/>[VM_utils.py]"]
  node_aws_req_utils["Request Dispatch<br/>[req_utils.py]"]
  node_simple_lb["Simple Load Balancer<br/>[SimpleLB.py]"]
end

node_operator(("Operator"))
node_aws_services{{"AWS Services"}}
node_vm_endpoint{{"VM Endpoint"}}
node_lambda{{"Lambda"}}

node_operator -->|"runs"| node_simulator
node_simulator -->|"loads settings"| node_config
node_simulator -->|"gets requests"| node_traffic
node_traffic -->|"reads workload"| node_traces
node_simulator -->|"passes requests"| node_manager
node_manager -->|"routes VM work"| node_vm
node_manager -->|"routes FaaS work"| node_serverless
node_vm -->|"provisions instances"| node_vm_instance
node_operator -->|"runs experiment"| node_aws_runner
node_aws_runner -->|"loads settings"| node_aws_config
node_aws_runner -->|"gets requests"| node_aws_traffic
node_aws_runner -->|"passes requests"| node_aws_manager
node_aws_manager -->|"dispatches requests"| node_aws_req_utils
node_aws_manager -->|"uses scaling"| node_aws_vm_utils
node_aws_runner -->|"sets up scaling"| node_aws_vm_utils
node_aws_vm_utils -->|"configures scaling"| node_aws_services
node_aws_manager -->|"checks health and alarms"| node_aws_services
node_aws_req_utils -->|"sends VM requests"| node_vm_endpoint
node_aws_req_utils -->|"invokes functions"| node_lambda
node_aws_req_utils -.->|"imports helper"| node_simple_lb
node_simple_lb -->|"discovers instances"| node_aws_services

click node_simulator "https://github.com/aliraza0337/libra/blob/main/simulator.py"
click node_config "https://github.com/aliraza0337/libra/blob/main/configuration.py"
click node_traffic "https://github.com/aliraza0337/libra/blob/main/traffic_generator.py"
click node_traces "https://github.com/aliraza0337/libra/tree/main/traces"
click node_manager "https://github.com/aliraza0337/libra/blob/main/manager.py"
click node_vm "https://github.com/aliraza0337/libra/blob/main/vm_cloud.py"
click node_vm_instance "https://github.com/aliraza0337/libra/blob/main/vm_cloud.py"
click node_serverless "https://github.com/aliraza0337/libra/blob/main/serverless_cloud.py"
click node_aws_runner "https://github.com/aliraza0337/libra/blob/main/aws/run_experiment.py"
click node_aws_config "https://github.com/aliraza0337/libra/blob/main/aws/configuration.py"
click node_aws_traffic "https://github.com/aliraza0337/libra/blob/main/aws/traffic_generator.py"
click node_aws_manager "https://github.com/aliraza0337/libra/blob/main/aws/manager.py"
click node_aws_vm_utils "https://github.com/aliraza0337/libra/blob/main/aws/VM_utils.py"
click node_aws_req_utils "https://github.com/aliraza0337/libra/blob/main/aws/req_utils.py"
click node_simple_lb "https://github.com/aliraza0337/libra/blob/main/aws/SimpleLB.py"

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_simulator,node_config,node_traffic,node_traces toneBlue
class node_manager toneAmber
class node_vm,node_vm_instance,node_serverless toneMint
class node_aws_runner,node_aws_config,node_aws_traffic,node_aws_manager,node_aws_vm_utils,node_aws_req_utils,node_simple_lb toneRose
class node_operator,node_aws_services,node_vm_endpoint,node_lambda toneIndigo
```

## Components

### Simulation

- [Simulator](https://github.com/aliraza0337/libra/blob/main/simulator.py): `simulator.py`
- [Simulation Config](https://github.com/aliraza0337/libra/blob/main/configuration.py): `configuration.py`
- [Trace Traffic](https://github.com/aliraza0337/libra/blob/main/traffic_generator.py): `traffic_generator.py`
- [Workload Traces](https://github.com/aliraza0337/libra/tree/main/traces): `traces`

### Hybrid Policy

- [Policy Manager](https://github.com/aliraza0337/libra/blob/main/manager.py): `manager.py`

### Compute Models

- [VM Cloud](https://github.com/aliraza0337/libra/blob/main/vm_cloud.py): `vm_cloud.py`
- [VM Instance](https://github.com/aliraza0337/libra/blob/main/vm_cloud.py): `vm_cloud.py`
- [Serverless Model](https://github.com/aliraza0337/libra/blob/main/serverless_cloud.py): `serverless_cloud.py`

### AWS Experiment

- [AWS Runner](https://github.com/aliraza0337/libra/blob/main/aws/run_experiment.py): `aws/run_experiment.py`
- [AWS Config](https://github.com/aliraza0337/libra/blob/main/aws/configuration.py): `aws/configuration.py`
- [AWS Traffic](https://github.com/aliraza0337/libra/blob/main/aws/traffic_generator.py): `aws/traffic_generator.py`
- [AWS Manager](https://github.com/aliraza0337/libra/blob/main/aws/manager.py): `aws/manager.py`
- [VM Scaling Utilities](https://github.com/aliraza0337/libra/blob/main/aws/VM_utils.py): `aws/VM_utils.py`
- [Request Dispatch](https://github.com/aliraza0337/libra/blob/main/aws/req_utils.py): `aws/req_utils.py`
- [Simple Load Balancer](https://github.com/aliraza0337/libra/blob/main/aws/SimpleLB.py): `aws/SimpleLB.py`

### Other components

- **Operator**
- **AWS Services**
- **VM Endpoint**
- **Lambda**

## Connections

- Operator → Simulator: runs (evidence: `README.md`)
- Simulator → Simulation Config: loads settings (evidence: `simulator.py`)
- Simulator → Trace Traffic: gets requests (evidence: `simulator.py`)
- Trace Traffic → Workload Traces: reads workload
- Simulator → Policy Manager: passes requests (evidence: `simulator.py`)
- Policy Manager → VM Cloud: routes VM work (evidence: `manager.py`)
- Policy Manager → Serverless Model: routes FaaS work (evidence: `manager.py`)
- VM Cloud → VM Instance: provisions instances (evidence: `vm_cloud.py`)
- Operator → AWS Runner: runs experiment (evidence: `aws/run_experiment.py`)
- AWS Runner → AWS Config: loads settings (evidence: `aws/run_experiment.py`)
- AWS Runner → AWS Traffic: gets requests (evidence: `aws/run_experiment.py`)
- AWS Runner → AWS Manager: passes requests (evidence: `aws/run_experiment.py`)
- AWS Manager → Request Dispatch: dispatches requests (evidence: `aws/manager.py`)
- AWS Manager → VM Scaling Utilities: uses scaling (evidence: `aws/manager.py`)
- AWS Runner → VM Scaling Utilities: sets up scaling (evidence: `aws/run_experiment.py`)
- VM Scaling Utilities → AWS Services: configures scaling (evidence: `aws/VM_utils.py`)
- AWS Manager → AWS Services: checks health and alarms (evidence: `aws/manager.py`)
- Request Dispatch → VM Endpoint: sends VM requests (evidence: `aws/req_utils.py`)
- Request Dispatch → Lambda: invokes functions (evidence: `aws/req_utils.py`)
- Request Dispatch → Simple Load Balancer: imports helper (evidence: `aws/req_utils.py`)
- Simple Load Balancer → AWS Services: discovers instances (evidence: `aws/SimpleLB.py`)
