# b1-ack/operating-system architecture

> Architecture diagram of the GitHub repository b1-ack/operating-system, 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/b1-ack/operating-system
- Repository: https://github.com/b1-ack/operating-system

## Overview

B1ackOS is a Debian-based Linux distribution, not an application runtime. Its documented user workflow is to use the system live or during installation, then install software from repositories. The tree shows three architecture-specific image configurations, including boot files, package lists, and repository settings. Source excerpts were not available, so the graph limits relationships to capabilities and workflow explicitly described in the README; it does not infer build-time control flow.

Main entry points: [`amd64/config`](https://github.com/b1-ack/operating-system/tree/main/amd64/config) (B1ackOS System), [`amd64/config/package-lists/minimal.list.chroot`](https://github.com/b1-ack/operating-system/blob/main/amd64/config/package-lists/minimal.list.chroot) (Software Installation), [`amd64/config/includes.binary/boot/grub/grub.cfg`](https://github.com/b1-ack/operating-system/blob/main/amd64/config/includes.binary/boot/grub/grub.cfg) (Live Boot Media), [`amd64/config/includes.binary/install`](https://github.com/b1-ack/operating-system/tree/main/amd64/config/includes.binary/install) (System Installer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_images["Architecture Images"]
  node_amd64_image["AMD64 Image Config"]
  node_arm64_image["ARM64 Image Config"]
  node_i386_image["i386 Image Config"]
end

subgraph group_boot["Boot and Install"]
  node_live_boot["Live Boot Media<br/>[grub.cfg]"]
  node_installer["System Installer<br/>[install]"]
  node_installed_system["B1ackOS System"]
end

subgraph group_software["Software and Privacy"]
  node_software_install["Software Installation"]
  node_repo_config["Repository Settings<br/>[b1ack.list.chroot]"]
  node_software_repositories[("Software Repositories")]
  node_privacy_focus["Privacy Focus"]
end

node_user(("Computer User"))

node_user -->|"uses live"| node_live_boot
node_user -->|"installs through"| node_installer
node_user -->|"uses installed"| node_installed_system
node_installed_system -->|"installs software"| node_software_install
node_software_install -->|"gets packages"| node_software_repositories

click node_amd64_image "https://github.com/b1-ack/operating-system/tree/main/amd64/config"
click node_arm64_image "https://github.com/b1-ack/operating-system/tree/main/arm64/config"
click node_i386_image "https://github.com/b1-ack/operating-system/tree/main/i386/config"
click node_live_boot "https://github.com/b1-ack/operating-system/blob/main/amd64/config/includes.binary/boot/grub/grub.cfg"
click node_installer "https://github.com/b1-ack/operating-system/tree/main/amd64/config/includes.binary/install"
click node_installed_system "https://github.com/b1-ack/operating-system/tree/main/amd64/config"
click node_software_install "https://github.com/b1-ack/operating-system/blob/main/amd64/config/package-lists/minimal.list.chroot"
click node_repo_config "https://github.com/b1-ack/operating-system/blob/main/amd64/config/archives/b1ack.list.chroot"
click node_privacy_focus "https://github.com/b1-ack/operating-system/tree/main/amd64/config"

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_amd64_image,node_arm64_image,node_i386_image,node_user toneBlue
class node_live_boot,node_installer,node_installed_system toneAmber
class node_software_install,node_repo_config,node_software_repositories,node_privacy_focus toneMint
```

## Components

### Architecture Images

- [AMD64 Image Config](https://github.com/b1-ack/operating-system/tree/main/amd64/config): `amd64/config`
- [ARM64 Image Config](https://github.com/b1-ack/operating-system/tree/main/arm64/config): `arm64/config`
- [i386 Image Config](https://github.com/b1-ack/operating-system/tree/main/i386/config): `i386/config`

### Boot and Install

- [Live Boot Media](https://github.com/b1-ack/operating-system/blob/main/amd64/config/includes.binary/boot/grub/grub.cfg): `amd64/config/includes.binary/boot/grub/grub.cfg`
- [System Installer](https://github.com/b1-ack/operating-system/tree/main/amd64/config/includes.binary/install): `amd64/config/includes.binary/install`
- [B1ackOS System](https://github.com/b1-ack/operating-system/tree/main/amd64/config): `amd64/config`

### Software and Privacy

- [Software Installation](https://github.com/b1-ack/operating-system/blob/main/amd64/config/package-lists/minimal.list.chroot): `amd64/config/package-lists/minimal.list.chroot`
- [Repository Settings](https://github.com/b1-ack/operating-system/blob/main/amd64/config/archives/b1ack.list.chroot): `amd64/config/archives/b1ack.list.chroot`
- **Software Repositories**
- [Privacy Focus](https://github.com/b1-ack/operating-system/tree/main/amd64/config): `amd64/config`

### Other components

- **Computer User**

## Connections

- Computer User → Live Boot Media: uses live (evidence: `README.md`)
- Computer User → System Installer: installs through (evidence: `README.md`)
- Computer User → B1ackOS System: uses installed (evidence: `README.md`)
- B1ackOS System → Software Installation: installs software (evidence: `README.md`)
- Software Installation → Software Repositories: gets packages (evidence: `README.md`)
