machineconfig 3.99__py3-none-any.whl → 7.66__py3-none-any.whl

machineconfig/setup_linux/{nix → others}/cli_installation.sh

@@ -1,12 +1,8 @@
 #!/bin/bash
-#=======================================================================
 # 📦 NIX CLI TOOLS INSTALLATION SCRIPT
-#=======================================================================
 # This script installs various command-line utilities using the Nix package manager
 
-echo """#=======================================================================
-🔄 SYSTEM UTILITIES | Installing system management tools
-#=======================================================================
+echo """🔄 SYSTEM UTILITIES | Installing system management tools
 """
 
 # System upgrade tool
@@ -21,9 +17,7 @@ nix-env -iA nixpkgs.procs || true
 echo "📥 Installing watchexec - executes commands when files change..."
 nix-env -iA nixpkgs.watchexec || true
 
-echo """#=======================================================================
-📂 FILE MANAGEMENT | Installing file browsers and utilities
-#=======================================================================
+echo """📂 FILE MANAGEMENT | Installing file browsers and utilities
 """
 
 # Terminal file managers
@@ -56,9 +50,7 @@ nix-env -iA nixpkgs.diskonaut || true
 echo "📥 Installing kondo - cleanup tool for dev projects..."
 nix-env -iA nixpkgs.kondo || true
 
-echo """#=======================================================================
-🖼️ VISUAL TOOLS | Installing terminal visualization tools
-#=======================================================================
+echo """🖼️ VISUAL TOOLS | Installing terminal visualization tools
 """
 
 # Terminal visualization
@@ -71,9 +63,7 @@ nix-env -iA nixpkgs.bottom || true
 echo "📥 Installing delta - syntax-highlighting pager for git..."
 nix-env -iA nixpkgs.delta || true
 
-echo """#=======================================================================
-🔧 DEVELOPMENT TOOLS | Installing programming utilities
-#=======================================================================
+echo """🔧 DEVELOPMENT TOOLS | Installing programming utilities
 """
 
 # Code editors
@@ -95,9 +85,7 @@ nix-env -iA nixpkgs.tokei || true
 echo "📥 Installing gitui - terminal UI for git..."
 nix-env -iA nixpkgs.gitui || true
 
-echo """#=======================================================================
-🔎 SEARCH TOOLS | Installing fuzzy finders and search utilities
-#=======================================================================
+echo """🔎 SEARCH TOOLS | Installing fuzzy finders and search utilities
 """
 
 # Search history
@@ -108,9 +96,7 @@ nix-env -iA nixpkgs.mcfly || true
 echo "📥 Installing skim - fuzzy finder in Rust..."
 nix-env -iA nixpkgs.skim || true
 
-echo """#=======================================================================
-🌐 NETWORK & CLOUD TOOLS | Installing file transfer and cloud utilities
-#=======================================================================
+echo """🌐 NETWORK & CLOUD TOOLS | Installing file transfer and cloud utilities
 """
 
 # File transfer
@@ -121,18 +107,14 @@ nix-env -iA nixpkgs.termscp || true
 echo "📥 Installing rclone - rsync for cloud storage..."
 nix-env -iA nixpkgs.rclone || true
 
-echo """#=======================================================================
-🛡️ SECURITY TOOLS | Installing password management utilities
-#=======================================================================
+echo """🛡️ SECURITY TOOLS | Installing password management utilities
 """
 
 # Password management
 echo "📥 Installing gopass - team password manager with git..."
 nix-env -iA nixpkgs.gopass || true
 
-echo """#=======================================================================
-📚 DOCUMENTATION | Installing help and reference tools
-#=======================================================================
+echo """📚 DOCUMENTATION | Installing help and reference tools
 """
 
 # Command reference
@@ -143,9 +125,7 @@ nix-env -iA nixpkgs.tldr || true
 echo "📥 Installing nushell - modern shell alternative..."
 nix-env -iA nixpkgs.nushell || true
 
-echo """#=======================================================================
-✅ INSTALLATION COMPLETE | All Nix CLI tools have been installed
-#=======================================================================
+echo """✅ INSTALLATION COMPLETE | All Nix CLI tools have been installed
 """
 
 # Commented out tools

machineconfig/setup_linux/ssh/openssh_all.sh

@@ -0,0 +1,25 @@
+#!/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 install openssh-server -y || true  # try to install first
+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/setup_linux/ssh/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/setup_linux/uv.sh

@@ -0,0 +1,15 @@
+#!/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
+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
+$HOME/.local/bin/uv python install 3.14

machineconfig/setup_linux/web_shortcuts/interactive.sh

@@ -1,9 +1,29 @@
 #!/bin/bash
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/uv.sh")
+. <( curl -sSL "https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/scripts/linux/wrap_mcfg")
 
-echo """
-=======================================================================
-📦 MACHINE CONFIGURATION | Interactive Installation Script. Installing uv then getting started.
-======================================================================="""
+alias devops='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" devops'
+alias cloud='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" cloud'
+alias agents='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" agents'
+alias sessions='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" sessions'
+alias ftpx='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" ftpx'
+alias fire='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" fire'
+alias croshell='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" croshell'
+alias utils='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" utils'
+alias terminal='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" terminal'
+alias msearch='$HOME/.local/bin/uvx --python 3.14 --from "machineconfig>=7.66" msearch'
 
-curl https://raw.githubusercontent.com/thisismygitrepo/machineconfig/main/src/machineconfig/setup_linux/ve.sh | bash
-$HOME/.local/bin/uv run --python 3.13 --with machineconfig devops ia
+alias d='wrap_in_shell_script devops'
+alias c='wrap_in_shell_script cloud'
+alias a='wrap_in_shell_script agents'
+alias ss='wrap_in_shell_script sessions'
+alias fx='wrap_in_shell_script ftpx'
+alias f='wrap_in_shell_script fire'
+alias rr='wrap_in_shell_script croshell'
+alias u='wrap_in_shell_script utils'
+alias t='wrap_in_shell_script terminal'
+alias ms='wrap_in_shell_script msearch'
+
+echo "mcfg command aliases are now defined in this shell session."
+
+devops self interactive

machineconfig/setup_mac/__init__.py

@@ -0,0 +1,16 @@
+"""Mac setup module for machineconfig.
+
+This module provides setup script locations and configurations for macOS systems.
+It mirrors the layout used by the Linux setup module and exposes Path objects
+pointing at common scripts (so other code can import these paths).
+"""
+
+from pathlib import Path
+
+
+# Optional helper scripts (may or may not exist)
+UV = Path(__file__).parent.joinpath("uv.sh")
+# Path to macOS SSH helper
+SSH_SETUP = Path(__file__).parent.joinpath("ssh/openssh_setup.sh")
+
+__all__ = ["UV", "SSH_SETUP"]

machineconfig/setup_mac/apps_gui.sh

@@ -0,0 +1,248 @@
+#!/usr/bin/env bash
+
+# macOS GUI Application Installation Script
+# Comprehensive GUI application installation via Homebrew Cask and Mac App Store
+# Supports Intel and Apple Silicon architectures
+
+set -e  # Exit on any error
+
+# Color codes for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+NC='\033[0m' # No Color
+
+# Logging functions
+log_info() {
+    echo -e "${BLUE}ℹ️  $1${NC}"
+}
+
+log_success() {
+    echo -e "${GREEN}✅ $1${NC}"
+}
+
+log_warning() {
+    echo -e "${YELLOW}⚠️  $1${NC}"
+}
+
+log_error() {
+    echo -e "${RED}❌ $1${NC}"
+}
+
+# Architecture detection
+detect_architecture() {
+    local arch=$(uname -m)
+    if [[ "$arch" == "arm64" ]]; then
+        echo "arm64"
+    elif [[ "$arch" == "x86_64" ]]; then
+        echo "amd64"
+    else
+        log_warning "Unknown architecture: $arch, defaulting to amd64"
+        echo "amd64"
+    fi
+}
+
+# Check if Homebrew is installed
+check_homebrew() {
+    if ! command -v brew &> /dev/null; then
+        log_error "Homebrew is not installed. Please run apps.sh first to install Homebrew."
+        exit 1
+    fi
+    log_success "Homebrew found"
+}
+
+# Setup Mac App Store CLI
+setup_mas() {
+    log_info "Setting up Mac App Store CLI (mas)..."
+    
+    if ! command -v mas &> /dev/null; then
+        log_info "Installing mas (Mac App Store CLI)..."
+        brew install mas || {
+            log_error "Failed to install mas"
+            return 1
+        }
+    else
+        log_success "mas already installed"
+    fi
+    
+    # Check if user is signed in to Mac App Store
+    if ! mas account &> /dev/null; then
+        log_warning "Not signed in to Mac App Store. Some applications may not install."
+        log_info "Please sign in to the Mac App Store manually to install App Store applications."
+    else
+        log_success "Signed in to Mac App Store"
+    fi
+}
+
+# Install a GUI application with error handling
+install_gui_app() {
+    local app_name="$1"
+    local description="$2"
+    local install_cmd="$3"
+    local fallback_cmd="$4"
+    
+    log_info "Installing $description..."
+    
+    if eval "$install_cmd"; then
+        log_success "$app_name installed successfully"
+        return 0
+    elif [[ -n "$fallback_cmd" ]]; then
+        log_warning "Primary installation failed, trying fallback method..."
+        if eval "$fallback_cmd"; then
+            log_success "$app_name installed via fallback method"
+            return 0
+        else
+            log_error "Failed to install $app_name via fallback method"
+            return 1
+        fi
+    else
+        log_error "Failed to install $app_name"
+        return 1
+    fi
+}
+
+# Install GUI applications from a list
+install_gui_app_list() {
+    local group_name="$1"
+    shift
+    local apps=("$@")
+    
+    log_info "Installing $group_name applications..."
+    
+    local failed_apps=()
+    for app_info in "${apps[@]}"; do
+        IFS='|' read -r app_name description install_cmd fallback_cmd <<< "$app_info"
+        if ! install_gui_app "$app_name" "$description" "$install_cmd" "$fallback_cmd"; then
+            failed_apps+=("$app_name")
+        fi
+    done
+    
+    if [[ ${#failed_apps[@]} -gt 0 ]]; then
+        log_warning "$group_name: Failed to install: ${failed_apps[*]}"
+    else
+        log_success "All $group_name applications installed successfully"
+    fi
+}
+
+# Main installation function
+main() {
+    log_info "Starting macOS GUI application installation..."
+    log_info "Detected architecture: $(detect_architecture)"
+    
+    # Check prerequisites
+    check_homebrew
+    setup_mas
+    
+    # --GROUP:BROWSERS - Web browsers
+    local browsers=(
+        "brave-browser|Brave Browser - Privacy-focused web browser|brew install --cask brave-browser|"
+        "google-chrome|Google Chrome web browser|brew install --cask google-chrome|"
+        "firefox|Mozilla Firefox web browser|brew install --cask firefox|"
+        "microsoft-edge|Microsoft Edge web browser|brew install --cask microsoft-edge|"
+        "safari-technology-preview|Safari Technology Preview|brew install --cask safari-technology-preview|"
+    )
+    
+    install_gui_app_list "Browsers" "${browsers[@]}"
+    
+    # --GROUP:CODE_EDITORS - Code editors and IDEs
+    local code_editors=(
+        "visual-studio-code|Visual Studio Code|brew install --cask visual-studio-code|"
+        "cursor|Cursor AI-powered code editor|brew install --cask cursor|"
+        "sublime-text|Sublime Text editor|brew install --cask sublime-text|"
+        "atom|Atom text editor|brew install --cask atom|"
+        "webstorm|JetBrains WebStorm IDE|brew install --cask webstorm|"
+        "pycharm|JetBrains PyCharm IDE|brew install --cask pycharm|"
+        "intellij-idea|JetBrains IntelliJ IDEA|brew install --cask intellij-idea|"
+        "xcode|Xcode development environment|mas install 497799835|brew install --cask xcode"
+    )
+    
+    install_gui_app_list "Code Editors & IDEs" "${code_editors[@]}"
+    
+    # --GROUP:PRODUCTIVITY - Productivity and office applications
+    local productivity=(
+        "obsidian|Obsidian note-taking app|brew install --cask obsidian|"
+        "notion|Notion workspace|brew install --cask notion|"
+        "bitwarden|Bitwarden password manager|brew install --cask bitwarden|"
+        "1password|1Password password manager|brew install --cask 1password|mas install 1333542190"
+        "alfred|Alfred productivity app|brew install --cask alfred|"
+        "raycast|Raycast launcher and productivity tool|brew install --cask raycast|"
+        "rectangle|Rectangle window management|brew install --cask rectangle|"
+        "magnet|Magnet window manager|mas install 441258766|brew install --cask magnet"
+        "cleanmymac|CleanMyMac X system cleaner|mas install 1339170533|"
+    )
+    
+    install_gui_app_list "Productivity" "${productivity[@]}"
+    
+    # --GROUP:MEDIA - Media and entertainment applications
+    local media=(
+        "vlc|VLC media player|brew install --cask vlc|"
+        "obs|OBS Studio for streaming and recording|brew install --cask obs|"
+        "handbrake|HandBrake video transcoder|brew install --cask handbrake|"
+        "spotify|Spotify music streaming|brew install --cask spotify|mas install 324684580"
+        "youtube-music|YouTube Music|brew install --cask youtube-music|"
+        "plex|Plex media server|brew install --cask plex|"
+        "keka|Keka archive utility|brew install --cask keka|mas install 470158793"
+        "the-unarchiver|The Unarchiver|brew install --cask the-unarchiver|mas install 425424353"
+    )
+    
+    install_gui_app_list "Media & Entertainment" "${media[@]}"
+    
+    # --GROUP:DEVELOPMENT - Development and system tools
+    local development=(
+        "docker|Docker Desktop|brew install --cask docker|"
+        "postman|Postman API development|brew install --cask postman|"
+        "insomnia|Insomnia REST client|brew install --cask insomnia|"
+        "github-desktop|GitHub Desktop|brew install --cask github-desktop|"
+        "sourcetree|Sourcetree Git client|brew install --cask sourcetree|"
+        "iterm2|iTerm2 terminal emulator|brew install --cask iterm2|"
+        "warp|Warp modern terminal|brew install --cask warp|"
+        "alacritty|Alacritty terminal emulator|brew install --cask alacritty|"
+    )
+    
+    install_gui_app_list "Development Tools" "${development[@]}"
+    
+    # --GROUP:DATABASE - Database management tools
+    local database=(
+        "dbeaver-community|DBeaver database tool|brew install --cask dbeaver-community|"
+        "sequel-pro|Sequel Pro MySQL client|brew install --cask sequel-pro|"
+        "tableplus|TablePlus database client|brew install --cask tableplus|"
+        "redis-insight|RedisInsight Redis GUI|brew install --cask redisinsight|"
+        "mongodb-compass|MongoDB Compass|brew install --cask mongodb-compass|"
+    )
+    
+    install_gui_app_list "Database Tools" "${database[@]}"
+    
+    # --GROUP:COMMUNICATION - Communication and collaboration
+    local communication=(
+        "slack|Slack team communication|brew install --cask slack|mas install 803453959"
+        "discord|Discord voice and text chat|brew install --cask discord|"
+        "zoom|Zoom video conferencing|brew install --cask zoom|"
+        "microsoft-teams|Microsoft Teams|brew install --cask microsoft-teams|"
+        "whatsapp|WhatsApp Desktop|brew install --cask whatsapp|mas install 1147396723"
+        "telegram|Telegram messaging|brew install --cask telegram|mas install 747648890"
+    )
+    
+    install_gui_app_list "Communication" "${communication[@]}"
+    
+    # --GROUP:SYSTEM_UTILITIES - System utilities and maintenance
+    local system_utilities=(
+        "appcleaner|AppCleaner uninstaller|brew install --cask appcleaner|"
+        "coconutbattery|CoconutBattery system info|brew install --cask coconutbattery|"
+        "disk-utility|Disk Utility (built-in)|echo 'Disk Utility is built into macOS'|"
+        "activity-monitor|Activity Monitor (built-in)|echo 'Activity Monitor is built into macOS'|"
+        "finder|Finder (built-in)|echo 'Finder is built into macOS'|"
+        "homebrew|Homebrew package manager|echo 'Homebrew already installed'|"
+    )
+    
+    install_gui_app_list "System Utilities" "${system_utilities[@]}"
+    
+    log_success "macOS GUI application installation completed!"
+    log_info "Some applications may require additional setup or signing in to your accounts."
+    log_info "Check Applications folder for newly installed apps."
+}
+
+# Execute main function if script is run directly
+if [[ "${BASH_SOURCE[0]}" == "${0}" ]]; then
+    main "$@"
+fi

machineconfig/setup_mac/ssh/openssh_setup.sh

@@ -0,0 +1,114 @@
+#!/usr/bin/env bash
+
+# 🔐 OpenSSH Setup for macOS
+# This script sets up SSH configuration and permissions on macOS
+
+echo "🔐 Starting OpenSSH setup for macOS..."
+
+# ✅ SSH is built-in on macOS (OpenSSH comes pre-installed)
+echo "✅ OpenSSH is pre-installed on macOS"
+
+# 📁 Create SSH directory with correct permissions
+echo "📁 Setting up SSH directory..."
+mkdir -p ~/.ssh
+chmod 700 ~/.ssh
+echo "✅ SSH directory created with correct permissions (700)"
+
+# 📝 Create authorized_keys file if it doesn't exist
+if [ ! -f ~/.ssh/authorized_keys ]; then
+    touch ~/.ssh/authorized_keys
+    chmod 600 ~/.ssh/authorized_keys
+    echo "✅ Created authorized_keys file"
+else
+    echo "✅ authorized_keys file already exists"
+    chmod 600 ~/.ssh/authorized_keys
+fi
+
+# 🔑 Create SSH keys if they don't exist
+if [ ! -f ~/.ssh/id_rsa ]; then
+    echo "🔑 Generating SSH keys (RSA)..."
+    ssh-keygen -t rsa -b 4096 -f ~/.ssh/id_rsa -N "" -C "$(whoami)@$(hostname)"
+    echo "✅ SSH RSA keys generated: ~/.ssh/id_rsa"
+else
+    echo "✅ SSH keys already exist"
+fi
+
+# 🔐 Create Ed25519 keys (modern alternative)
+if [ ! -f ~/.ssh/id_ed25519 ]; then
+    echo "🔑 Generating SSH keys (Ed25519)..."
+    ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519 -N "" -C "$(whoami)@$(hostname)"
+    echo "✅ SSH Ed25519 keys generated: ~/.ssh/id_ed25519"
+else
+    echo "✅ SSH Ed25519 keys already exist"
+fi
+
+# 🔧 Configure SSH config file for convenience
+SSH_CONFIG="$HOME/.ssh/config"
+if [ ! -f "$SSH_CONFIG" ]; then
+    echo "📝 Creating SSH config file..."
+    cat > "$SSH_CONFIG" << 'EOF'
+# SSH Config File for macOS
+# Add your remote hosts below
+
+# Example host configuration:
+# Host myserver
+#     HostName example.com
+#     User username
+#     Port 22
+#     IdentityFile ~/.ssh/id_ed25519
+#     IdentityFile ~/.ssh/id_rsa
+
+# Global settings
+Host *
+    AddKeysToAgent yes
+    UseKeychain yes
+    IdentityFile ~/.ssh/id_ed25519
+    IdentityFile ~/.ssh/id_rsa
+    ServerAliveInterval 60
+EOF
+    chmod 600 "$SSH_CONFIG"
+    echo "✅ SSH config file created: $SSH_CONFIG"
+else
+    echo "✅ SSH config file already exists"
+fi
+
+# 🔒 Ensure correct file permissions
+echo "🔒 Setting correct SSH file permissions..."
+chmod 700 ~/.ssh
+chmod 600 ~/.ssh/authorized_keys 2>/dev/null || true
+chmod 600 ~/.ssh/id_rsa 2>/dev/null || true
+chmod 644 ~/.ssh/id_rsa.pub 2>/dev/null || true
+chmod 600 ~/.ssh/id_ed25519 2>/dev/null || true
+chmod 644 ~/.ssh/id_ed25519.pub 2>/dev/null || true
+chmod 600 ~/.ssh/config 2>/dev/null || true
+echo "✅ SSH file permissions configured correctly"
+
+# ℹ️ Display SSH key information
+echo ""
+echo "📋 SSH Setup Summary:"
+echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
+echo "SSH Directory: ~/.ssh"
+echo "SSH Config: ~/.ssh/config"
+echo ""
+echo "Available SSH Keys:"
+if [ -f ~/.ssh/id_rsa.pub ]; then
+    echo "  • RSA Key: ~/.ssh/id_rsa"
+fi
+if [ -f ~/.ssh/id_ed25519.pub ]; then
+    echo "  • Ed25519 Key: ~/.ssh/id_ed25519"
+fi
+echo ""
+echo "💡 Next Steps:"
+echo "  1. View your public key:"
+echo "     cat ~/.ssh/id_ed25519.pub  (or id_rsa.pub)"
+echo "  2. Add it to your GitHub/GitLab/server authorized_keys"
+echo "  3. Test connection:"
+echo "     ssh -v your_server"
+echo "  4. Configure hosts in ~/.ssh/config for easy access"
+echo ""
+echo "📚 Learn more about SSH:"
+echo "  • man ssh"
+echo "  • man ssh-keygen"
+echo "  • man ssh_config"
+echo ""
+echo "✅ OpenSSH setup complete!"

machineconfig/setup_mac/uv.sh

@@ -0,0 +1,36 @@
+#!/usr/bin/env bash
+
+# Install or update uv (universal version manager) on macOS
+# Mirrors Linux uv installer but adapts PATH and locations for mac
+
+set -euo pipefail
+
+UV_BIN="$HOME/.local/bin/uv"
+
+if [ ! -f "$UV_BIN" ]; then
+    echo "📦 uv binary not found — installing uv to $HOME/.local/bin..."
+    mkdir -p "$HOME/.local/bin"
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    echo "✅ uv installed to $UV_BIN"
+else
+    echo "🔄 uv binary found — attempting self-update..."
+    "$UV_BIN" self update || true
+fi
+
+# Ensure local bin is in PATH for this run
+export PATH="$HOME/.local/bin:$PATH"
+
+if ! command -v uv &> /dev/null; then
+    echo "⚠️ uv not found in PATH even after install; add \"$HOME/.local/bin\" to your shell profile"
+else
+    echo "🔧 uv available: $(command -v uv)"
+fi
+
+# Example uv usage: ensure Python 3.14 is available (adjust as needed)
+if command -v uv &> /dev/null; then
+    echo "📥 Ensuring Python 3.14 via uv (if supported)"
+    # uv may manage various runtimes; this is an example command and will be skipped gracefully if unsupported
+    uv python install 3.14 || true
+fi
+
+echo "✅ uv setup complete"

machineconfig/setup_windows/__init__.py

@@ -0,0 +1,8 @@
+
+from pathlib import Path
+
+UV = Path(__file__).parent.joinpath("uv.ps1")
+DOCKER = Path(__file__).parent.joinpath("others/docker.ps1")
+OBS = Path(__file__).parent.joinpath("others/obs.ps1")
+POWER_OPTIONS = Path(__file__).parent.joinpath("others/power_options.ps1")
+SSH_SERVER = Path(__file__).parent.joinpath("ssh/openssh_server.ps1")

machineconfig/setup_windows/others/power_options.ps1

@@ -0,0 +1,7 @@
+
+# power and sleep options.
+Powercfg /Change monitor-timeout-ac 60
+Powercfg /Change monitor-timeout-dc 0
+Powercfg /Change standby-timeout-ac 0
+Powercfg /Change standby-timeout-dc 0
+