Skip to content

Conversation

@Justadudeinspace
Copy link
Collaborator

Motivation

  • Provide a single, hardened, cross-platform installer entrypoint at scripts/install.sh that replaces the previous install.sh and install_deps.sh split.
  • Make installation safe, idempotent and debuggable with strict bash flags, traps and a non-interactive default path.
  • Support multiple install methods (pipx, uv, local venv, pip --user) and installation --mode choices (pypi|prod|dev) with clear fallbacks.
  • Best-effort system dependency provisioning for Termux, proot-distro, Linux distros, macOS and guidance for Windows shells.

Description

  • Added scripts/install.sh as the unified installer implementing environment detection helpers (is_termux, is_proot, is_wsl, is_macos, is_windows, distro detection), strict hardening (set -euo pipefail, IFS, trap) and debug support via --debug.
  • Implemented install methods and switches: prefers pipx, falls back to uv, supports --venv (local .venv), --pip-user, --mode <pypi|prod|dev>, and optional --prefix; also added --dry-run to print planned actions.
  • Best-effort system package installs implemented for Termux (pkg install python3 ...), Debian/Ubuntu (apt-get package set), Fedora/RHEL (dnf), Arch (pacman), and macOS (Homebrew guidance); includes a proot-vs-Termux prefix warning to avoid prefix hijack.
  • Removed the old top-level install.sh and install_deps.sh, updated README.md and documentation to reference scripts/install.sh, pinned curl/wget bootstrap snippets to v3.0.0 tag, and ensured scripts/install.sh is executable (chmod +x scripts/install.sh).

Testing

  • Ran a syntax check with bash -n scripts/install.sh which completed successfully.
  • Executed a dry-run smoke test ./scripts/install.sh --dry-run which printed a detected environment summary and planned install method (output shown during rollout).
  • Attempted shellcheck scripts/install.sh but shellcheck was not available in the environment (not executed).
  • Verified repository docs and CI/usage snippets were updated to call scripts/install.sh and curl/wget lines were updated to the v3.0.0 tag.

Codex Task

Copy link
Collaborator Author

@Justadudeinspace Justadudeinspace left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@Justadudeinspace Justadudeinspace merged commit f735057 into main Jan 12, 2026
6 of 8 checks passed
@Justadudeinspace Justadudeinspace deleted the codex/merge-install-scripts-into-single-installer branch January 12, 2026 23:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants