v1.0.17: migrate from pipx to uv for all installers and documentation

Author: sinsniwal

README.md

@@ -71,10 +71,10 @@ Invoke-WebRequest -Uri "https://raw.githubusercontent.com/sinsniwal/hey-cli/main
 
 Download `hey.exe` from the [latest release](https://github.com/sinsniwal/hey-cli/releases/latest). No Python required.
 
-### pip / pipx
+### uv (Recommended)
 
 ```bash
-pipx install hey-cli-python
+uv tool install hey-cli-python
 ```
 
 > **Note:** After installation, authenticate with `ollama login` and pull the default model: `ollama pull gpt-oss:20b-cloud`
@@ -187,8 +187,9 @@ hey "your question"
 ```
 
 - **Zero external API calls** — communicates with Ollama via `localhost:11434` using Python's built-in `urllib`.
-- **Zero compiled dependencies** — the only runtime dependency is `rich` (for terminal formatting).
-- **Pure Python 3.9–3.14** — no C extensions, no Rust, no build tools required.
+- **Zero compiled dependencies** — the core logic is pure Python (only `rich` is used for formatting).
+- **Pure Python 3.9–3.14** — works with `uv`, `pipx`, or standard `pip`. No build tools required.
+- **Instant Speed** — Installation with `uv` or `brew` binaries takes < 2 seconds.
 
 ---
 

install.ps1

@@ -2,7 +2,7 @@
 .SYNOPSIS
 Installs hey-cli natively across Windows architectures.
 .DESCRIPTION
-This script verifies Python is installed, forces a user-level pipx installation,
+This script verifies Python is installed, forces a user-level uv installation,
 validates Ollama runtime logic, downloads the default specified model, and natively builds hey.
 
 Alternative install methods (no Python required):
@@ -14,7 +14,7 @@ $ErrorActionPreference = "Stop"
 $ModelName = "gpt-oss:20b-cloud"
 
 Write-Host "Welcome to the hey-cli Windows installer!" -ForegroundColor Cyan
-Write-Host "This script will setup Python dependencies, verify Ollama, and build hey-cli locally."
+Write-Host "This script will setup uv and Python dependencies, verify Ollama, and build hey-cli locally."
 Write-Host ""
 
 # 1. Check Python
@@ -27,15 +27,21 @@ try {
     Exit 1
 }
 
-# 2. Setup pipx
+# 2. Setup uv
 try {
-    $pipxCheck = & pipx --version 2>&1
-    Write-Host "[OK] pipx found." -ForegroundColor Green
+    $uvCheck = & uv --version 2>&1
+    Write-Host "[OK] uv found." -ForegroundColor Green
 } catch {
-    Write-Host "pipx not found. Installing via python..." -ForegroundColor Cyan
-    & python -m pip install --user pipx
-    & python -m pipx ensurepath
-    Write-Host "pipx installed. You may need to restart your terminal for the pipx path to register." -ForegroundColor Yellow
+    Write-Host "uv not found. Installing via official script..." -ForegroundColor Cyan
+    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
+    # Update current session path
+    $env:PATH = "$env:USERPROFILE\.local\bin;$env:PATH"
+    
+    if (!(Get-Command uv -ErrorAction SilentlyContinue)) {
+        Write-Host "[ERROR] uv installation failed or not in PATH." -ForegroundColor Red
+        Write-Host "Please install uv manually: https://github.com/astral-sh/uv" -ForegroundColor Yellow
+        Exit 1
+    }
 }
 
 # 3. Setup Ollama
@@ -110,7 +116,7 @@ try {
 # 6. Install hey-cli
 Write-Host ""
 Write-Host "Installing hey-cli-python..." -ForegroundColor Cyan
-& pipx install hey-cli-python --force
+& uv tool install hey-cli-python --force
 
 Write-Host ""
 Write-Host "============ SUCCESS =============" -ForegroundColor Green

install.sh

@@ -19,7 +19,7 @@ if [ "$(uname -s)" = "Darwin" ]; then
 fi
 
 echo -e "${BLUE}Welcome to the hey-cli cross-platform installer!${NC}"
-echo -e "This script will setup Python, pipx, Ollama, and explicitly build hey-cli locally.\n"
+echo -e "This script will setup Python, uv, Ollama, and explicitly build hey-cli locally.\n"
 
 # 1. Check Python
 if ! command -v python3 &> /dev/null; then
@@ -28,34 +28,19 @@ if ! command -v python3 &> /dev/null; then
 fi
 echo -e "✔️  Python 3 found."
 
-# 2. Setup pipx
-if ! command -v pipx &> /dev/null; then
-    echo -e "${BLUE}pipx not found. Attempting to install via system package manager...${NC}"
-    OS="$(uname -s)"
-    if [ "$OS" = "Darwin" ]; then
-        if command -v brew &> /dev/null; then
-            $BREW_CMD install pipx
-        else
-            echo -e "${RED}Homebrew not found. Please install pipx manually: https://pipx.pypa.io/stable/installation/${NC}"
-            exit 1
-        fi
-    elif [ "$OS" = "Linux" ]; then
-        if command -v apt-get &> /dev/null; then
-            sudo apt-get update && sudo apt-get install -y pipx
-        elif command -v dnf &> /dev/null; then
-            sudo dnf install -y pipx
-        elif command -v pacman &> /dev/null; then
-            sudo pacman -Sy --noconfirm python-pipx
-        elif command -v zypper &> /dev/null; then
-            sudo zypper install -y python3-pipx
-        else
-             echo -e "${RED}Unsupported Linux package manager. Please install pipx manually.${NC}"
-             exit 1
-        fi
+# 2. Setup uv
+if ! command -v uv &> /dev/null; then
+    echo -e "${BLUE}uv not found. Attempting to install via official script...${NC}"
+    curl -LsSf https://astral.sh/uv/install.sh | sh
+    # Ensure uv is in the PATH for this session
+    export PATH="$HOME/.local/bin:$PATH"
+    
+    if ! command -v uv &> /dev/null; then
+        echo -e "${RED}uv installation failed or not in PATH. Please install uv manually: https://docs.astral.sh/uv/getting-started/installation/${NC}"
+        exit 1
     fi
-    pipx ensurepath --force
 else
-    echo -e "✔️  pipx found."
+    echo -e "✔️  uv found."
 fi
 
 # 3. Setup Ollama
@@ -116,9 +101,9 @@ ollama pull "$MODEL" || echo -e "${RED}Warning: Could not pull $MODEL. Ensure 'o
 # 6. Install hey-cli
 echo -e "\n${BLUE}Installing hey-cli-python...${NC}"
 if [ "$(uname -s)" = "Darwin" ] && [ "$(uname -m)" = "x86_64" ] && [ "$(sysctl -in sysctl.proc_translated 2>/dev/null)" = "1" ]; then
-    arch -arm64 pipx install hey-cli-python --force
+    arch -arm64 uv tool install hey-cli-python --force
 else
-    pipx install hey-cli-python --force
+    uv tool install hey-cli-python --force
 fi
 
 echo -e "\n${GREEN}============ SUCCESS =============${NC}"

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta"
 
 [project]
 name = "hey-cli-python"
-version = "1.0.16"
+version = "1.0.17"
 description = "A secure, zero-bloat CLI companion that turns natural language and error logs into executable commands."
 readme = "README.md"
 requires-python = ">=3.9"

uninstall.ps1

@@ -2,7 +2,7 @@
 .SYNOPSIS
 Uninstalls hey-cli from Windows.
 .DESCRIPTION
-Removes hey-cli installed via pipx, pip, Scoop, or standalone binary.
+Removes hey-cli installed via uv, pipx, pip, Scoop, or standalone binary.
 Optionally removes configuration files.
 #>
 
@@ -25,7 +25,18 @@ try {
     }
 } catch {}
 
-# 2. pipx
+# 2. uv
+try {
+    $uvCheck = & uv tool list 2>&1 | Select-String "hey-cli-python"
+    if ($uvCheck) {
+        Write-Host "Removing hey-cli via uv..." -ForegroundColor Cyan
+        & uv tool uninstall hey-cli-python
+        Write-Host "[OK] uv package removed." -ForegroundColor Green
+        $Removed = $true
+    }
+} catch {}
+
+# 3. pipx
 try {
     $pipxList = & pipx list 2>&1
     if ($pipxList -match "hey-cli-python") {
@@ -36,7 +47,7 @@ try {
     }
 } catch {}
 
-# 3. pip (fallback)
+# 4. pip (fallback)
 try {
     $pipShow = & pip show hey-cli-python 2>&1
     if ($LASTEXITCODE -eq 0) {
@@ -47,7 +58,7 @@ try {
     }
 } catch {}
 
-# 4. Standalone binary
+# 5. Standalone binary
 $StandalonePath = "$env:LOCALAPPDATA\hey-cli\hey.exe"
 if (Test-Path $StandalonePath) {
     Write-Host "Removing standalone binary..." -ForegroundColor Cyan
@@ -57,7 +68,7 @@ if (Test-Path $StandalonePath) {
 }
 
 if (-not $Removed) {
-    Write-Host "No hey-cli installation found (checked Scoop, pipx, pip, standalone)." -ForegroundColor Yellow
+    Write-Host "No hey-cli installation found (checked Scoop, uv, pipx, pip, standalone)." -ForegroundColor Yellow
 }
 
 # 5. Config files

uninstall.sh

@@ -20,15 +20,25 @@ if command -v brew &> /dev/null && brew list hey-cli &> /dev/null 2>&1; then
     REMOVED=1
 fi
 
-# 2. pipx
+# 2. uv
+if command -v uv &> /dev/null; then
+    if uv tool list 2>/dev/null | grep -q "hey-cli-python"; then
+        echo -e "${BLUE}Removing hey-cli via uv...${NC}"
+        uv tool uninstall hey-cli-python
+        echo -e "${GREEN}[OK] uv package removed.${NC}"
+        REMOVED=1
+    fi
+fi
+
+# 3. pipx
 if command -v pipx &> /dev/null && pipx list 2>/dev/null | grep -q "hey-cli-python"; then
     echo -e "${BLUE}Removing hey-cli via pipx...${NC}"
     pipx uninstall hey-cli-python
     echo -e "${GREEN}[OK] pipx package removed.${NC}"
     REMOVED=1
 fi
 
-# 3. pip (fallback)
+# 4. pip (fallback)
 if pip show hey-cli-python &> /dev/null 2>&1; then
     echo -e "${BLUE}Removing hey-cli via pip...${NC}"
     pip uninstall hey-cli-python -y
@@ -37,7 +47,7 @@ if pip show hey-cli-python &> /dev/null 2>&1; then
 fi
 
 if [ "$REMOVED" -eq 0 ]; then
-    echo -e "${YELLOW}No hey-cli installation found (checked Homebrew, pipx, pip).${NC}"
+    echo -e "${YELLOW}No hey-cli installation found (checked Homebrew, uv, pipx, pip).${NC}"
 fi
 
 # 4. Config files