# s1len7/silent_sdk architecture

> Architecture diagram of the GitHub repository s1len7/silent_sdk, 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/s1len7/silent_sdk
- Repository: https://github.com/s1len7/silent_sdk

## Overview

silent_sdk is a hardware-specific setup and configuration repository, with separate install entry points for personal computers, Raspberry Pi devices, servers, and other named hardware. Its main workflow is choosing a device, running that device’s setup entry point, and applying its configuration; the README documents those entry points but most setup-script internals were not sampled, so their internal call chains are omitted. The repository also includes Codyssey API tools and device-specific runtime configurations. Those sampled components are shown separately, with relationships limited to visible calls or README statements.

Main entry points: [`tools/codyssey-cli/codyssey_cli.py`](https://github.com/s1len7/silent_sdk/blob/main/tools/codyssey-cli/codyssey_cli.py) (Codyssey CLI), [`tools/codyssey-proxy/codyssey_proxy.py`](https://github.com/s1len7/silent_sdk/blob/main/tools/codyssey-proxy/codyssey_proxy.py) (API compatibility proxy), [`devices/ds218plus/scripts/synoproj.py`](https://github.com/s1len7/silent_sdk/blob/main/devices/ds218plus/scripts/synoproj.py) (Project manager), [`devices/desktop/setup.ps1`](https://github.com/s1len7/silent_sdk/blob/main/devices/desktop/setup.ps1) (Windows setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_device_setup["Device setup"]
  node_windows_setup["Windows setup<br/>[setup.ps1]"]
  node_borrowed_windows["Borrowed Windows setup<br/>[setup.ps1]"]
  node_ubuntu_setup["Ubuntu setup<br/>[setup.sh]"]
  node_pi_display_setup["Pi display setup<br/>[setup.sh]"]
  node_pi_lite_setup["Pi Lite setup<br/>[setup.sh]"]
  node_pi5_setup["Pi 5 setup<br/>[setup.sh]"]
  node_host_setup["Proxmox host setup<br/>[setup_host.sh]"]
  node_mac_setup["macOS setup<br/>[setup.sh]"]
end

subgraph group_device_runtime["Device runtimes"]
  node_pi_rotation["Display rotation<br/>[auto_rotate.py]"]
  node_mirror_config["Mirror configuration<br/>[config.js]"]
end

subgraph group_codyssey_tools["Codyssey tools"]
  node_codyssey_cli["Codyssey CLI<br/>[codyssey_cli.py]"]
  node_codyssey_proxy["API compatibility proxy<br/>[codyssey_proxy.py]"]
end

subgraph group_nas_services["NAS services"]
  node_nas_projects["NAS container projects"]
  node_nas_project_manager["Project manager<br/>[synoproj.py]"]
end

node_operator(("Device owner"))
node_codyssey_gateway["Codyssey gateway"]
node_synology_api["Synology Docker API"]

node_operator -->|"runs setup"| node_windows_setup
node_operator -->|"runs setup"| node_borrowed_windows
node_operator -->|"runs setup"| node_ubuntu_setup
node_operator -->|"runs setup"| node_pi_display_setup
node_operator -->|"runs setup"| node_pi_lite_setup
node_operator -->|"runs setup"| node_pi5_setup
node_operator -->|"runs setup"| node_host_setup
node_operator -->|"runs setup"| node_mac_setup
node_codyssey_cli -->|"calls API"| node_codyssey_gateway
node_codyssey_proxy -->|"forwards requests"| node_codyssey_gateway
node_nas_project_manager -->|"invokes API"| node_synology_api

click node_windows_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/desktop/setup.ps1"
click node_borrowed_windows "https://github.com/s1len7/silent_sdk/blob/main/devices/generic-windows/setup.ps1"
click node_ubuntu_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/generic-ubuntu/setup.sh"
click node_pi_display_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-display/setup.sh"
click node_pi_lite_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-2gb/setup.sh"
click node_pi5_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/pi5/setup.sh"
click node_host_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/b150m-am2/setup_host.sh"
click node_mac_setup "https://github.com/s1len7/silent_sdk/blob/main/devices/imac-27-2019/setup.sh"
click node_pi_rotation "https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-display/toggle_rotate/auto_rotate.py"
click node_mirror_config "https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-display/docker/magic_mirror/data/config/config.js"
click node_codyssey_cli "https://github.com/s1len7/silent_sdk/blob/main/tools/codyssey-cli/codyssey_cli.py"
click node_codyssey_proxy "https://github.com/s1len7/silent_sdk/blob/main/tools/codyssey-proxy/codyssey_proxy.py"
click node_nas_projects "https://github.com/s1len7/silent_sdk/tree/main/devices/ds218plus/projects"
click node_nas_project_manager "https://github.com/s1len7/silent_sdk/blob/main/devices/ds218plus/scripts/synoproj.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_windows_setup,node_borrowed_windows,node_ubuntu_setup,node_pi_display_setup,node_pi_lite_setup,node_pi5_setup,node_host_setup,node_mac_setup toneBlue
class node_pi_rotation,node_mirror_config toneAmber
class node_codyssey_cli,node_codyssey_proxy,node_synology_api toneMint
class node_nas_projects,node_nas_project_manager toneRose
class node_operator,node_codyssey_gateway toneIndigo
```

## Components

### Device setup

- [Windows setup](https://github.com/s1len7/silent_sdk/blob/main/devices/desktop/setup.ps1): `devices/desktop/setup.ps1`
- [Borrowed Windows setup](https://github.com/s1len7/silent_sdk/blob/main/devices/generic-windows/setup.ps1): `devices/generic-windows/setup.ps1`
- [Ubuntu setup](https://github.com/s1len7/silent_sdk/blob/main/devices/generic-ubuntu/setup.sh): `devices/generic-ubuntu/setup.sh`
- [Pi display setup](https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-display/setup.sh): `devices/pi4-display/setup.sh`
- [Pi Lite setup](https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-2gb/setup.sh): `devices/pi4-2gb/setup.sh`
- [Pi 5 setup](https://github.com/s1len7/silent_sdk/blob/main/devices/pi5/setup.sh): `devices/pi5/setup.sh`
- [Proxmox host setup](https://github.com/s1len7/silent_sdk/blob/main/devices/b150m-am2/setup_host.sh): `devices/b150m-am2/setup_host.sh`
- [macOS setup](https://github.com/s1len7/silent_sdk/blob/main/devices/imac-27-2019/setup.sh): `devices/imac-27-2019/setup.sh`

### Device runtimes

- [Display rotation](https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-display/toggle_rotate/auto_rotate.py): `devices/pi4-display/toggle_rotate/auto_rotate.py`
- [Mirror configuration](https://github.com/s1len7/silent_sdk/blob/main/devices/pi4-display/docker/magic_mirror/data/config/config.js): `devices/pi4-display/docker/magic_mirror/data/config/config.js`

### Codyssey tools

- [Codyssey CLI](https://github.com/s1len7/silent_sdk/blob/main/tools/codyssey-cli/codyssey_cli.py): `tools/codyssey-cli/codyssey_cli.py`
- [API compatibility proxy](https://github.com/s1len7/silent_sdk/blob/main/tools/codyssey-proxy/codyssey_proxy.py): `tools/codyssey-proxy/codyssey_proxy.py`

### NAS services

- [NAS container projects](https://github.com/s1len7/silent_sdk/tree/main/devices/ds218plus/projects): `devices/ds218plus/projects`
- [Project manager](https://github.com/s1len7/silent_sdk/blob/main/devices/ds218plus/scripts/synoproj.py): `devices/ds218plus/scripts/synoproj.py`

### Other components

- **Device owner**
- **Codyssey gateway**
- **Synology Docker API**

## Connections

- Device owner → Windows setup: runs setup (evidence: `README.md`)
- Device owner → Borrowed Windows setup: runs setup (evidence: `README.md`)
- Device owner → Ubuntu setup: runs setup (evidence: `README.md`)
- Device owner → Pi display setup: runs setup (evidence: `README.md`)
- Device owner → Pi Lite setup: runs setup (evidence: `README.md`)
- Device owner → Pi 5 setup: runs setup (evidence: `README.md`)
- Device owner → Proxmox host setup: runs setup (evidence: `README.md`)
- Device owner → macOS setup: runs setup (evidence: `README.md`)
- Codyssey CLI → Codyssey gateway: calls API (evidence: `tools/codyssey-cli/codyssey_cli.py`)
- API compatibility proxy → Codyssey gateway: forwards requests (evidence: `tools/codyssey-proxy/codyssey_proxy.py`)
- Project manager → Synology Docker API: invokes API (evidence: `devices/ds218plus/scripts/synoproj.py`)
