machineconfig 5.14__tar.gz → 5.16__tar.gz

{machineconfig-5.14 → machineconfig-5.16}/MANIFEST.in

@@ -3,5 +3,5 @@ graft ./src/machineconfig/settings/*
 graft ./src/machineconfig/jobs/*
 graft ./src/machineconfig/profile/*
 graft ./src/machineconfig/scripts/*
-graft ./src/machineconfig/setup_linux/*
-graft ./src/machineconfig/setup_windows/*
+graft ./src/machineconfig/setup_linux
+graft ./src/machineconfig/setup_windows

{machineconfig-5.14/src/machineconfig.egg-info → machineconfig-5.16}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: machineconfig
-Version: 5.14
+Version: 5.16
 Summary: Dotfiles management package
 Author-email: Alex Al-Saffar <programmer@usa.com>
 License: Apache 2.0

{machineconfig-5.14 → machineconfig-5.16}/pyproject.toml

@@ -6,7 +6,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "machineconfig"
-version = "5.14"
+version = "5.16"
 description = "Dotfiles management package"
 readme = "README.md"
 license = {text = "Apache 2.0"}
@@ -76,6 +76,7 @@ croshell = "machineconfig.scripts.python.croshell:arg_parser"
 
 [tool.setuptools]
 package-dir = {"" = "src"}
+include-package-data = true
 license-files = []
 
 [tool.setuptools.packages.find]
@@ -84,6 +85,7 @@ where = ["src"]
 [dependency-groups]
 dev = [
     "aider>=0.2.6",
+    "build>=1.3.0",
     "cleanpy>=0.5.1",
     "cowsay>=6.1",
     "ipdb>=0.13.13",

{machineconfig-5.14 → machineconfig-5.16}/src/machineconfig/scripts/python/count_lines_frontend.py

@@ -8,8 +8,8 @@ def analyze_repo_development(repo_path: str = typer.Argument(..., help="Path to
     count_lines_path = Path(count_lines.__file__)
     # --project $HOME/code/machineconfig 
     cmd = f"""uv run --python 3.13 --with machineconfig[plot] {count_lines_path} analyze-over-time {repo_path}"""
-    from machineconfig.utils.code import run_script
-    run_script(cmd)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(cmd)
 
 
 if __name__ == "__main__":

{machineconfig-5.14 → machineconfig-5.16}/src/machineconfig/scripts/python/croshell.py

@@ -145,8 +145,8 @@ from pathlib import Path
         else: profile = ""
         fire_line = f"uv run --python 3.13 --with machineconfig[plot] {interpreter} {interactivity} {profile} {str(pyfile)}"
 
-    from machineconfig.utils.code import run_script
-    run_script(fire_line)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(fire_line)
 
 
 def arg_parser() -> None:

{machineconfig-5.14 → machineconfig-5.16}/src/machineconfig/scripts/python/fire_jobs.py

@@ -221,8 +221,8 @@ python -m machineconfig.cluster.templates.cli_click --file {choice_file} """
             command = "$ErrorActionPreference = 'SilentlyContinue';\n" + command + "\nStart-Sleep -Seconds 0.5"
         else:
             raise NotImplementedError(f"Platform {platform.system()} not supported.")
-    from machineconfig.utils.code import run_script
-    run_script(command)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(command)
 
 
 def main(

{machineconfig-5.14 → machineconfig-5.16}/src/machineconfig/scripts/python/interactive.py

@@ -27,27 +27,23 @@ from questionary import Choice
 from rich.console import Console
 from rich.panel import Panel
 from rich.text import Text
-from machineconfig.utils.code import run_script as run_command
+from machineconfig.utils.code import run_shell_script
 
 _ = cast
 console = Console()
 
 
 def display_header() -> None:
-    """Display the script header."""
     header_text = Text("MACHINE CONFIGURATION", style="bold magenta")
     subtitle_text = Text("Interactive Installation Script", style="italic cyan")
     console.print(Panel(f"📦 {header_text}\n{subtitle_text}", border_style="blue", padding=(1, 2)))
 def display_completion_message() -> None:
-    """Display completion message."""
     completion_text = Text("INSTALLATION COMPLETE", style="bold green")
     subtitle_text = Text("System setup finished successfully", style="italic green")
     console.print(Panel(f"✨ {completion_text}\n{subtitle_text}\n\n🎉 Your system has been configured successfully!\n🔄 You may need to reboot to apply all changes.", border_style="green", padding=(1, 2)))
 def display_dotfiles_instructions() -> None:
-    """Display instructions for dotfiles migration."""
     header_text = Text("DOTFILES MIGRATION", style="bold yellow")
     subtitle_text = Text("Configuration transfer options", style="italic yellow")
-
     instructions = """
 🖱️  [bold blue]Method 1: USING MOUSE WITHOUT KB OR BROWSER SHARE[/bold blue]
     On original machine, run:
@@ -65,32 +61,9 @@ def display_dotfiles_instructions() -> None:
     [dim]cd ~
     cloud_copy SHARE_URL . --config ss[/dim]
     (requires symlinks to be created first)"""
-
     console.print(Panel(f"📂 {header_text}\n{subtitle_text}\n\n{instructions}", border_style="yellow", padding=(1, 2)))
 
 
-def install_windows_desktop_apps() -> bool:
-    """Install Windows desktop applications using winget."""
-    if system() != "Windows":
-        console.print("❌ This function is only available on Windows systems.", style="bold red")
-        return False   
-    console.print("🔧 Installing Nerd Fonts", style="bold cyan")
-    try:
-        from machineconfig.jobs.installer.custom_dev.nerfont_windows_helper import install_nerd_fonts
-        install_nerd_fonts()
-        console.print("✅ Nerd Fonts installed successfully", style="bold green")
-    except Exception as e:
-        console.print(f"❌ Error installing Nerd Fonts: {e}", style="bold red")
-    console.print("🔧 Setting Windows Terminal settings", style="bold cyan")
-    try:
-        from machineconfig.setup_windows.wt_and_pwsh.set_wt_settings import main as set_wt_settings_main
-        set_wt_settings_main()
-        console.print("✅ Windows Terminal settings configured successfully", style="bold green")
-    except Exception as e:
-        console.print(f"❌ Error setting Windows Terminal settings: {e}", style="bold red")    
-    return True
-
-
 def get_installation_choices() -> list[str]:
     """Get user choices for installation options."""
     choices = [
@@ -114,11 +87,15 @@ def get_installation_choices() -> list[str]:
 
 
 def execute_installations(selected_options: list[str]) -> None:
-    """Execute the selected installation options."""
     if system() == "Windows":
-        run_command("$HOME/.local/bin/uv.exe self update")
+        from machineconfig import setup_windows as module
+        script_path = Path(module.__file__).parent / "ve.ps1"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
     else:
-        run_command("$HOME/.local/bin/uv self update")
+        from machineconfig import setup_linux as module
+        script_path = Path(module.__file__).parent / "ve.sh"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
+
     for maybe_a_group in selected_options:
         if maybe_a_group in ("ESSENTIAL", "DEV", "ESSENTIAL_SYSTEM", "DEV_SYSTEM", "TerminalEyeCandy"):
             console.print(Panel("⚡ [bold bright_yellow]CLI APPLICATIONS[/bold bright_yellow]\n[italic]Command-line tools installation[/italic]", border_style="bright_yellow"))
@@ -129,21 +106,25 @@ def execute_installations(selected_options: list[str]) -> None:
                 console.print("✅ CLI applications installed successfully", style="bold green")
             except Exception as e:
                 console.print(f"❌ Error installing CLI applications: {e}", style="bold red")
-            run_command(". $HOME/.bashrc")
+            run_shell_script(". $HOME/.bashrc")
 
     if "upgrade_system" in selected_options:
         if system() == "Windows":
             console.print("❌ System upgrade is not applicable on Windows via this script.", style="bold red")
         elif system() == "Linux":
             console.print(Panel("🔄 [bold magenta]SYSTEM UPDATE[/bold magenta]\n[italic]Package management[/italic]", border_style="magenta"))
-            run_command("sudo nala upgrade -y")
+            run_shell_script("sudo nala upgrade -y")
         else:
             console.print(f"❌ System upgrade not supported on {system()}.", style="bold red")
     if "install_repos" in selected_options:
         console.print(Panel("🐍 [bold green]PYTHON ENVIRONMENT[/bold green]\n[italic]Virtual environment setup[/italic]", border_style="green"))
-        from machineconfig import setup_linux as module
-        script = Path(module.__file__).parent / "repos.sh"
-        run_command(f"bash {script}")
+        if system() == "Windows":
+            from machineconfig import setup_windows as module
+            script_path = Path(module.__file__).parent / "repos.ps1"
+        else:
+            from machineconfig import setup_linux as module
+            script_path = Path(module.__file__).parent / "repos.sh"
+        run_shell_script(script_path.read_text(encoding="utf-8"))
 
     if "install_ssh_server" in selected_options:
         console.print(Panel("🔒 [bold red]SSH SERVER[/bold red]\n[italic]Remote access setup[/italic]", border_style="red"))
@@ -152,9 +133,9 @@ def execute_installations(selected_options: list[str]) -> None:
 Add-WindowsCapability -Online -Name OpenSSH.Server~~~~0.0.1.0
 Start-Service sshd
 Set-Service -Name sshd -StartupType 'Automatic'"""
-            run_command(f'powershell -Command "{powershell_script}"')
+            run_shell_script(f'powershell -Command "{powershell_script}"')
         else:
-            run_command("sudo nala install openssh-server -y")
+            run_shell_script("sudo nala install openssh-server -y")
 
     if "install_shell_profile" in selected_options:
         console.print(Panel("🐚 [bold green]SHELL PROFILE[/bold green]\n[italic]Shell configuration setup[/italic]", border_style="green"))
@@ -179,8 +160,8 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
                 console.print("✅ Symlinks created successfully", style="bold green")
             except Exception as e:
                 console.print(f"❌ Error creating symlinks: {e}", style="bold red")
-            run_command("sudo chmod 600 $HOME/.ssh/*")
-            run_command("sudo chmod 700 $HOME/.ssh")
+            run_shell_script("sudo chmod 600 $HOME/.ssh/*")
+            run_shell_script("sudo chmod 700 $HOME/.ssh")
         else:
             console.print("⏭️  Skipping symlink creation - finish dotfiles transfer first", style="yellow")
 
@@ -200,7 +181,10 @@ Set-Service -Name sshd -StartupType 'Automatic'"""
             console.print(f"❌ Error retrieving backup data: {e}", style="bold red")
 
     if "install_windows_desktop" in selected_options:
-        install_windows_desktop_apps()
+        from machineconfig.jobs.installer.custom_dev.nerfont_windows_helper import install_nerd_fonts
+        install_nerd_fonts()
+        from machineconfig.setup_windows.wt_and_pwsh.set_wt_settings import main as set_wt_settings_main
+        set_wt_settings_main()
 
 
 def main() -> None:
@@ -210,7 +194,7 @@ def main() -> None:
     if not selected_options:
         console.print("❌ No options selected. Exiting...", style="bold red")
         sys.exit(0)
-    console.print(f"\n✅ Selected options: {', '.join(selected_options)}", style="bold green")
+    console.print(f"\n✅ Selected options: {'\n'.join(selected_options)}", style="bold green")
     proceed = questionary.confirm("🚀 Proceed with installation?", default=True).ask()
     if not proceed:
         console.print("❌ Installation cancelled.", style="bold red")

{machineconfig-5.14 → machineconfig-5.16}/src/machineconfig/scripts/python/share_terminal.py

@@ -132,8 +132,8 @@ def main(
 #!/bin/bash
 ttyd --writable -t enableSixel=true {ssl_args} --port {port} --credential "{username}:{password}" -t 'theme={{"background": "black"}}' {start_command}
 """
-    from machineconfig.utils.code import run_script
-    run_script(code)
+    from machineconfig.utils.code import run_shell_script
+    run_shell_script(code)
 
 
 def main_with_parser():

machineconfig-5.16/src/machineconfig/setup_linux/apps.sh

@@ -0,0 +1,69 @@
+#!/usr/bin/env bash
+
+
+# --GROUP:ESSENTIAL_SYSTEM:git,nano,net-utils,wget,curl,nala,nvm,nodejs
+echo "🔄 Updating apt package lists..."
+echo "📥 Installing nala package manager..."
+echo "📥 Installing essential network tools..."
+echo "📥 Installing Node Version Manager (NVM)..."
+sudo apt update -y || true
+sudo apt install nala -y || true
+sudo nala install curl wget gpg lsb-release apt-transport-https -y || true
+sudo nala install git net-tools htop nano -y || true
+curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.3/install.sh | bash
+echo "🔧 Configuring NVM environment..."
+export NVM_DIR="$HOME/.nvm"
+[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"
+[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
+echo "📥 Installing latest Node.js..."
+nvm install node || true
+
+# --GROUP:TerminalEyeCandy:fortune,toilet,sl,aafire,cmatrix,hollywood,chafa
+echo "📥 Installing fortune - random wisdom generator..."
+echo "📥 Installing toilet - large ASCII text generator..."
+echo "📥 Installing sl - steam locomotive animation..."
+echo "📥 Installing aafire - ASCII art fire animation..."
+echo "📥 Installing cmatrix - Matrix-style terminal animation..."
+echo "📥 Installing hollywood - Hollywood hacker terminal effect..."
+echo "📥 Installing chafa - terminal image viewer..."
+sudo nala install cowsay -y || true
+sudo nala install lolcat -y || true
+sudo nala install boxes -y || true
+sudo nala install figlet -y || true
+sudo nala install fortune -y || true
+sudo nala install toilet -y || true
+sudo nala install chafa -y
+sudo nala install sl -y || true
+sudo nala install libaa-bin -y
+echo 'keyboard-configuration keyboard-configuration/layout select US English' | sudo debconf-set-selections
+echo 'keyboard-configuration keyboard-configuration/layoutcode string us' | sudo debconf-set-selections
+sudo DEBIAN_FRONTEND=noninteractive nala install -y cmatrix
+sudo nala install hollywood -y || true
+
+# --GROUP:NetworkTools: sshfs,samba,fuse3,nfs-common
+echo "📥 Installing sshfs - mount remote filesystems over SSH..."
+echo "📥 Installing Samba - LAN-based file sharing..."
+sudo nala install sshfs
+sudo nala install samba
+sudo nala install fuse3 -y || true
+sudo nala install nfs-common -y || true
+
+# --GROUP:DEV_SYSTEM: graphviz,make,rust,libssl-dev,sqlite3,postgresql-client,redis-tools
+echo "📥 Installing Graphviz - graph visualization software..."
+echo "📥 Installing make - build automation tool..."
+echo "📥 Installing SSL development libraries for Rust..."
+echo "📥 Installing Rust programming language and toolchain..."
+sudo nala install graphviz -y || true
+sudo nala install ffmpeg -y || true  # Required by some dev tools
+sudo nala install make -y || true  # Required by LunarVim and SpaceVim
+(curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh) || true
+sudo nala install libssl-dev -y
+
+
+# --GROUP:DATABASES: sqlite3,postgresql-client,redis-tools
+echo "📥 Installing SQLite - lightweight SQL database..."
+echo "📥 Installing PostgreSQL client..."
+echo "📥 Installing Redis command-line tools..."
+sudo nala install sqlite3 -y || true
+sudo nala install postgresql-client -y || true
+sudo nala install redis-tools -y || true

machineconfig-5.16/src/machineconfig/setup_linux/apps_desktop.sh

@@ -0,0 +1,113 @@
+#!/usr/bin/bash
+#=======================================================================
+# 🖥️ DESKTOP APPLICATIONS INSTALLATION SCRIPT
+#=======================================================================
+# This script installs desktop applications for a Linux workstation
+
+echo """#=======================================================================
+🌐 WEB BROWSERS | Installing browser applications
+#=======================================================================
+"""
+# Google Chrome installation (commented reference)
+# echo "📥 Installing Google Chrome..."
+# wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
+# sudo dpkg -i google-chrome-stable_current_amd64.deb
+
+echo """#=======================================================================
+📝 TEXT EDITORS | Installing Neovim editor
+#=======================================================================
+"""
+echo "📥 Installing Neovim via Homebrew..."
+/home/linuxbrew/.linuxbrew/bin/brew install neovim
+
+echo """#=======================================================================
+📧 EMAIL CLIENT | Installing Thunderbird
+#=======================================================================
+"""
+echo "📥 Installing Thunderbird via Flatpak..."
+flatpak install flathub org.mozilla.Thunderbird
+
+echo """#=======================================================================
+🖲️ TERMINAL EMULATOR | Installing WezTerm
+#=======================================================================
+"""
+echo "📥 Installing WezTerm via Flatpak..."
+flatpak install flathub org.wezfurlong.wezterm
+echo "🚀 Launching WezTerm..."
+flatpak run org.wezfurlong.wezterm
+
+echo """#=======================================================================
+✏️ SCREEN ANNOTATION | Installing Gromit-MPX
+#=======================================================================
+"""
+echo "📥 Installing Gromit-MPX via Flatpak..."
+flatpak install net.christianbeier.Gromit-MPX
+
+echo """#=======================================================================
+📋 CLIPBOARD MANAGERS | Installing CopyQ
+#=======================================================================
+"""
+echo "📥 Installing CopyQ via Flatpak..."
+flatpak install flathub com.github.hluk.copyq --noninteractive
+
+echo """#=======================================================================
+🔗 REMOTE DESKTOP | Installing Remmina
+#=======================================================================
+"""
+echo "📥 Installing Remmina and RDP plugin..."
+sudo nala install remmina remmina-plugin-rdp -y
+
+# Alternative Remmina installation via flatpak (reference)
+# echo "📥 Setting up Flatpak repositories..."
+# flatpak remote-add --user --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
+# flatpak install org.freedesktop.Platform
+# flatpak install org.freedesktop.Platform.openh264
+# flatpak install --user flathub org.remmina.Remmina
+# flatpak run --user org.remmina.Remmina
+
+echo """#=======================================================================
+🚀 APPLICATION LAUNCHER | Installing Rofi
+#=======================================================================
+"""
+echo "📥 Installing Rofi application launcher..."
+sudo nala install rofi -y
+
+echo """#=======================================================================
+📎 CLIPBOARD HISTORY | Installing Greenclip
+#=======================================================================
+"""
+# Session type detection (reference)
+# session_type=$(echo $XDG_SESSION_TYPE)
+# if [ "$session_type" == "x11" ]; then
+#     echo "Detected X11 session. Installing X11-related packages and tools..."
+#     sudo nala install xdotool xsel xclip -y
+# elif [ "$session_type" == "wayland" ]; then
+#     echo "Detected Wayland session. Installing Wayland-related packages and tools..."
+#     sudo nala install wl-copy wtype -y
+# else
+#     echo "Unknown session type: $session_type"
+#     exit 1
+# fi
+
+echo "📥 Downloading and installing Greenclip clipboard manager..."
+wget -P ~/Downloads https://github.com/erebe/greenclip/releases/download/v4.2/greenclip
+chmod +x ~/Downloads/greenclip
+sudo mv ~/Downloads/greenclip /usr/bin/
+
+echo "ℹ️ Usage instructions:"
+echo "- Start daemon: greenclip daemon &"
+echo "- With Rofi: rofi -modi \"clipboard:greenclip print\" -show clipboard -run-command '{cmd}'"
+echo "- For emoji picker: rofi -modi \"emoji:rofimoji\" -show emoji"
+echo "- Application launcher: rofi -show drun"
+
+echo """#=======================================================================
+🔄 APPLICATION LINKING | Linking applications to user space
+#=======================================================================
+"""
+echo "🔗 Creating application symlinks..."
+ln -s /home/$USER/.nix-profile/share/applications/* /home/$USER/.local/share/applications/
+
+echo """#=======================================================================
+✅ INSTALLATION COMPLETE | Desktop applications have been installed
+#=======================================================================
+"""

machineconfig-5.16/src/machineconfig/setup_linux/apps_gui.sh

@@ -0,0 +1,74 @@
+#!/bin/bash
+#=======================================================================
+# 🖥️ GUI APPLICATIONS AND DESKTOP ENVIRONMENT SETUP SCRIPT
+#=======================================================================
+# This script installs graphical user interfaces and desktop environments
+
+echo """#=======================================================================
+📦 INSTALLING GUI COMPONENTS | Setting up desktop environment
+#=======================================================================
+"""
+
+# echo "📥 Installing Nautilus file manager..."
+# sudo nala install nautilus -y  # 📂 graphical file manager
+# sudo nala install x11-apps  # 🎨 few graphical test apps like xeyes
+
+echo "📥 Installing XRDP - Remote Desktop Protocol server..."
+sudo nala install xrdp -y  # 🔌 remote desktop protocol
+
+# echo "📥 Installing X.Org server and components..."
+# sudo nala install xorg -y  # 🎯 xorg server
+# sudo nala install xinit -y  # 🚀 xorg init
+# sudo nala install xserver-xorg -y  # 🖼️ xorg server
+
+echo "📥 Installing XFCE4 desktop environment..."
+sudo nala install xfce4 -y  # 🏠 xfce4 desktop environment
+
+echo "📥 Installing XFCE4 additional components..."
+sudo nala install xfce4-goodies -y  # ✨ xfce4 desktop environment extras
+
+echo """#=======================================================================
+🔧 CONFIGURING XRDP | Setting up Remote Desktop service
+#=======================================================================
+"""
+
+# Back up original configuration
+echo "📄 Creating backup of XRDP configuration..."
+sudo cp /etc/xrdp/xrdp.ini /etc/xrdp/xrdp.ini.bak
+
+# Change default port to avoid conflict with Windows RDP
+echo "🔢 Changing XRDP port to 3391..."
+sudo sed -i 's/3389/3391/g' /etc/xrdp/xrdp.ini
+
+# Configure color depth and display settings
+echo "🎨 Configuring display quality settings..."
+sudo sed -i 's/max_bpp=32/#max_bpp=32\nmax_bpp=128/g' /etc/xrdp/xrdp.ini
+sudo sed -i 's/xserverbpp=24/#xserverbpp=24\nxserverbpp=128/g' /etc/xrdp/xrdp.ini
+
+# Set default session
+echo "🖥️ Setting up default XFCE4 session..."
+echo xfce4-session > ~/.xsession
+
+# Configure startup window manager
+echo "🚀 Configuring window manager startup..."
+sudo sed -i 's/test/#test/g' /etc/xrdp/startwm.sh
+sudo sed -i 's/exec/#exec/g' /etc/xrdp/startwm.sh
+echo "startxfce4" | sudo tee -a /etc/xrdp/startwm.sh
+
+echo """#=======================================================================
+🚀 STARTING SERVICES | Initializing XRDP service
+#=======================================================================
+"""
+
+echo "🔄 Starting XRDP service..."
+sudo /etc/init.d/xrdp start
+
+echo """#=======================================================================
+✅ SETUP COMPLETE | GUI environment has been configured
+#=======================================================================
+"""
+echo "ℹ️ Connect to this machine via Remote Desktop using port 3391"
+# Alternative commands:
+# sudo systemctl restart xrdp
+# sudo service xrdp restart
+

machineconfig-5.16/src/machineconfig/setup_linux/openssh_all.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/bash
+# 🔐 OpenSSH Server Setup and Configuration
+
+# Common pitfalls: 
+# 🚫 Wrong line endings (LF/CRLF) in config files
+# 🌐 Network port conflicts (try 2222 -> 2223) between WSL and Windows
+
+# 📁 Setup SSH directory and permissions
+mkdir -p ~/.ssh
+echo $pubkey_string >> ~/.ssh/authorized_keys
+sudo chmod 600 ~/.ssh/*
+sudo chmod 700 ~/.ssh
+echo "✅ FINISHED modifying .ssh folder attributes."
+
+# 🔄 Clean install OpenSSH server
+sudo nala purge openssh-server -y
+sudo nala install openssh-server -y
+echo "✅ FINISHED installing openssh-server."
+
+# 📝 Additional commands if needed:
+# sudo service ssh status
+# sudo nano /etc/ssh/sshd_config
+# sudo service ssh restart
+# For tunnels see: https://www.youtube.com/watch?v=Wp7boqm3Xts

machineconfig-5.16/src/machineconfig/setup_linux/openssh_wsl.sh

@@ -0,0 +1,38 @@
+#!/usr/bin/bash
+# 🐧 WSL2 SSH Configuration for LAN Access 🌐
+# Purpose: Enable SSH access to WSL2 from LAN (requires wsl_server.ps1 in Windows)
+# Common pitfall: sshd fails after config changes due to wrong line endings/permissions
+
+# 🔍 Check if running in WSL
+if [[ $(uname -a) == *"icrosoft"* ]]; then
+  echo "✅ Running inside WSL"
+else
+  echo "❌ Not running inside WSL, no need for this script"
+  exit 0
+fi
+
+# 🔢 Set SSH port
+if [ -z "$port" ]; then
+  port=2222
+  echo "📝 Port variable not defined, setting it to $port"
+fi
+
+# 🛠️ Configure SSH
+sudo cp /etc/ssh/sshd_config /etc/ssh/sshd_config.bak
+sudo sed -i 's/#Port 22/Port '$port'/g' /etc/ssh/sshd_config
+sudo sed -i 's/#ListenAddress 0.0.0.0/ListenAddress 0.0.0.0/g' /etc/ssh/sshd_config
+sudo sed -i 's/#PubkeyAuthentication yes/PubkeyAuthentication yes/g' /etc/ssh/sshd_config
+sudo sed -i 's/PasswordAuthentication no/PasswordAuthentication yes/g' /etc/ssh/sshd_config
+
+# 🔑 Generate host keys and restart service
+sudo service ssh start
+sudo ssh-keygen -A
+sudo service ssh --full-restart
+sudo service ssh status
+
+echo "✨ FINISHED configuring SSH in WSL2."
+
+# 📚 References:
+# Service startup: https://superuser.com/questions/1701853/how-to-enable-a-service-to-start-with-wsl2
+# WSL config: https://learn.microsoft.com/en-us/windows/wsl/networking#accessing-a-wsl-2-distribution-from-your-local-area-network-lan
+

machineconfig-5.16/src/machineconfig/setup_linux/repos.sh

@@ -0,0 +1,48 @@
+#!/usr/bin/bash
+
+
+echo """
+#=======================================================================
+🔄 REPOSITORIES SETUP | Cloning project codebases
+#=======================================================================
+"""
+
+echo """📥 Setting up repositories...
+   🐊 crocodile     - Main utility package
+   🔧 machineconfig - System configuration tools
+"""
+
+mkdir -p $HOME/code
+cd $HOME/code
+# Setup crocodile repository
+if [ -d "crocodile" ]; then
+    echo """🔄 crocodile directory exists, updating...
+    """
+    cd crocodile
+    git reset --hard
+    git pull
+    cd ..
+else
+    echo """⏳ Cloning crocodile repository...
+    """
+    git clone https://github.com/thisismygitrepo/crocodile.git --depth 4
+fi
+
+# Setup machineconfig repository
+cd $HOME/code
+if [ -d "machineconfig" ]; then
+    echo """🔄 machineconfig directory exists, updating...
+    """
+    cd machineconfig
+    git reset --hard
+    git pull
+    cd ..
+else
+    echo """⏳ Cloning machineconfig repository...
+    """
+    git clone https://github.com/thisismygitrepo/machineconfig --depth 4  # Choose browser-based authentication.
+fi
+
+cd $HOME/code/machineconfig
+$HOME/.local/bin/uv sync --no-dev
+$HOME/.local/bin/uv cache clean

machineconfig-5.16/src/machineconfig/setup_linux/ve.sh

@@ -0,0 +1,20 @@
+#!/usr/bin/bash
+
+if [ ! -f "$HOME/.local/bin/uv" ]; then
+    echo """📦 uv binary not found
+   ⏳ Installing uv package manager..."""
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+else
+    echo """🔄 Updating uv package manager..."""
+    $HOME/.local/bin/uv self update
+fi
+# Add uv to PATH if not already there
+if ! command -v uv &> /dev/null; then
+    echo """🔍 uv command not found in PATH
+   ➕ Adding uv to system PATH...
+"""
+    export PATH="$HOME/.local/bin:$PATH"
+fi
+echo """✅ uv is installed and ready to use."""
+
+$HOME/.local/bin/uv python install 3.13