Repolode
Submit
AmineDjeghri

AmineDjeghri/personal-os-setup

A cross-OS terminal UI and docs hub that automates setting up Windows, Linux, macOS, WSL2, Google TV with Stremio, and Home Assistant.

View on GitHubWebsite
Stars
659
Forks
49
Open issues
6
Last commit
yesterday

What is it?

Personal OS Setup is a terminal UI application paired with a documentation site for configuring a new machine consistently across Windows 11, Linux, macOS, and WSL2. From one TUI you can install packages, set up Zsh and Oh My Zsh, manage WSL, install GPU drivers, sync dotfiles with chezmoi, configure Windows Terminal, and run Docker post-install steps.

The project also covers setups beyond the workstation: the docs include guides for a living room setup with Google TV and Stremio, and for a home server running Home Assistant. Installation is a single shell or PowerShell command that places the repo in a local directory and adds a personal-os-setup command to your path. The app runs git pull on each launch to stay current.

Developers who want to fork or modify it can clone the repo and use the included install scripts or make targets. The project also provides make targets that start disposable KVM/QEMU virtual machines for testing the setup before running it on a real machine.

Key features

  • 01Terminal UI for installing packages and running system setup actions on Windows, Linux, and macOS.
  • 02Configures Zsh with Oh My Zsh and syncs dotfiles with chezmoi.
  • 03Handles WSL management and GPU driver installation.
  • 04Includes Windows Terminal configuration and Docker post-install steps.
  • 05Provides documentation for Google TV with Stremio and Home Assistant setups.
  • 06Auto-updates the installed copy on each launch.

Use cases

  • Setting up a new Windows 11 machine with WSL2 and developer tools.
  • Standardizing shell and dotfiles across a Linux or macOS laptop.
  • Preparing a living room Google TV with Stremio.
  • Testing a machine setup in a disposable VM before applying it to a real computer.

Quick start

  1. 1

    Install on Linux, WSL2 or macOS

    Install with the official instructions in the README
  2. 2

    Install on Windows 11 (PowerShell as administrator)

    $u='https://raw.githubusercontent.com/AmineDjeghri/personal-os-setup/main/install_windows.ps1'; $p="$env:TEMP\install_windows.ps1"; iwr $u -UseBasicParsing -OutFile $p; powershell -ExecutionPolicy Bypass -File $p
  3. 3

    Launch the terminal UI

    personal-os-setup

Things to know

  • The setup automates system changes across several OSes, so test in a VM or review actions before running on your real machine.
  • The app auto-runs git pull on every launch, so the installed checkout changes without manual review.

Topics

#dotfiles#wsl2#windows-setup#zsh#developer-environment#terminal-ui#home-assistant#chezmoi#apps#cuda

FAQ

What is personal-os-setup?
A cross-OS terminal UI and docs hub that automates setting up Windows, Linux, macOS, WSL2, Google TV with Stremio, and Home Assistant. Personal OS Setup is a terminal UI application paired with a documentation site for configuring a new machine consistently across Windows 11, Linux, macOS, and WSL2. From one TUI you can install packages, set up Zsh and Oh My Zsh, manage WSL, install GPU drivers, sync dotfiles with chezmoi, configure Windows Terminal, and run Docker post-install steps.
Is personal-os-setup free to use? What license does it have?
personal-os-setup is open source under the MIT license. Check the license terms before using it in commercial products.
Is personal-os-setup still maintained?
Actively maintained. The last commit to personal-os-setup was on Oct 19, 2026.
What can I use personal-os-setup for?
Setting up a new Windows 11 machine with WSL2 and developer tools. Standardizing shell and dotfiles across a Linux or macOS laptop. Preparing a living room Google TV with Stremio. Testing a machine setup in a disposable VM before applying it to a real computer.
How do I install personal-os-setup?
Install on Linux, WSL2 or macOS Install on Windows 11 (PowerShell as administrator): $u='https://raw.githubusercontent.com/AmineDjeghri/personal-os-setup/main/install_windows.ps1'; $p="$env:TEMP\install_windows.ps1"; iwr $u -UseBasicParsing -OutFile $p; powershell -ExecutionPolicy Bypass -File $p Launch the terminal UI: personal-os-setup
Where can I get personal-os-setup?
The source code and installation instructions are on GitHub: https://github.com/AmineDjeghri/personal-os-setup

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects