Sami Ahmed 1ff4110b70
SamiOS CI / lint-and-test (push) Successful in 10s
[grade=B] SSOT: VERSION single-source-of-truth across all 7 components
- Add VERSION at repo root (canonical) + airootfs mirror
- Refactor samios CLI, voice-bridge, installer, profiledef,
  desktop-setup, PKGBUILD to derive VERSION from canonical file via
  walk-up or conditional read (no embedded release-version literals)
- Makefile targets: version-set NEW=X (single file change), version-sync
- tests/test_version.sh: 55 assertions locking the invariants

Verified end-to-end:
  make version-set NEW=0.3.0-rc2 → all 7 components see 0.3.0-rc2;
  PKGBUILD transforms hyphen to underscore for Arch.

Codex verdict: B (0 blocking issues, shippable).
2026-08-11 06:57:17 -07:00

SamiOS - A Custom Arch Linux Distribution

Overview

SamiOS is a custom Linux distribution based on Arch Linux, designed as a Windows replacement for personal use.

Features

  • Rolling release (Arch-based)
  • Custom CLI tool (samios) for system management
  • Automated installation scripts
  • Custom branding and configuration
  • Font policy: excludes fonts with "7777" in the name

Building from Source

Prerequisites

# On Arch Linux
sudo pacman -S archiso git

Clone and Build

git clone https://git.sami/sami7777/samios.git
cd samios/packaging/archiso
sudo ./build.sh

Installation

From ISO

  1. Boot from the generated ISO
  2. Run the automated installer:
    samios install
    

Manual Installation

See docs/installation.md for detailed instructions.

CLI Tool

The samios command provides system management:

samios status    # Show system status
samios update    # Update system
samios install   # Install packages
samios fonts     # Manage fonts
samios help      # Show all commands

Font Policy

SamiOS excludes any fonts with "7777" in the filename as these are personal branding fonts.

Development

This project is under active development. See docs/roadmap.md for planned features.

License

TBD

S
Description
SamiOS — Arch-based production OS, built and shipped by Sami Ahmed
Readme 1.4 MiB
Languages
Shell 88.8%
Python 8.7%
Makefile 2.5%