Installation
Install curl-runner on your system using your preferred package manager or download a pre-built binary.
Prerequisites
Bun Runtime
Mandatorycurl-runner is optimized for Bun and provides the best performance when used with Bun runtime.
# Install Bun (if not already installed)
curl -fsSL https://bun.sh/install | bash
# Verify Bun installation
bun --versionQuick Install
The fastest way to install curl-runner. Downloads the latest pre-compiled binary, verifies checksum, and adds to PATH automatically.
Linux / macOS
Recommendedcurl -fsSL https://www.curl-runner.com/install.sh | bashWindows (PowerShell)
irm https://www.curl-runner.com/install.ps1 | iexNo Prerequisites
The installer downloads a standalone binary with Bun bundled. No runtime dependencies required.
Package Managers
Bun Package Manager
Install using Bun for optimal performance and compatibility.
bun install -g @curl-runner/clinpm Package Manager
Install using npm if you prefer Node.js ecosystem tools.
npm install -g @curl-runner/cliPrerequisites
For npm/yarn/pnpm installation: Bun runtime must be installed on your system.
Install Bun: curl -fsSL https://bun.sh/install | bash
For standalone builds: No prerequisites needed! The standalone executable includes Bun bundled within it.
Pre-compiled Binaries
Download standalone executables with no dependencies required.
Installation Instructions
Linux / macOS
# Download the binary (replace VERSION with actual version)
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/curl-runner-cli-VERSION-linux-x64.tar.gz
# Extract the archive
tar -xzf curl-runner-cli-VERSION-linux-x64.tar.gz
# Make executable
chmod +x curl-runner
# Move to PATH (optional)
sudo mv curl-runner /usr/local/bin/
# Verify installation
curl-runner --versionWindows (PowerShell)
# Download the binary (replace VERSION with actual version)
Invoke-WebRequest -Uri "https://github.com/alexvcasillas/curl-runner/releases/latest/download/curl-runner-cli-VERSION-windows-x64.zip" -OutFile "curl-runner.zip"
# Extract the archive
Expand-Archive -Path curl-runner.zip -DestinationPath .
# Add to PATH (optional - run as Administrator)
$env:PATH += ";$PWD"
# Verify installation
curl-runner --versionVerify Checksum (Recommended)
Always verify the download integrity using SHA256 checksums.
Linux:
# Download checksums file
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/SHA256SUMS.txt
# Verify the download
sha256sum -c SHA256SUMS.txt --ignore-missingmacOS:
# Download checksums file
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/SHA256SUMS.txt
# Verify the download
shasum -a 256 -c SHA256SUMS.txtWindows (PowerShell):
# Download checksums file
Invoke-WebRequest -Uri "https://github.com/alexvcasillas/curl-runner/releases/latest/download/SHA256SUMS.txt" -OutFile "SHA256SUMS.txt"
# Get file hash
$hash = (Get-FileHash -Algorithm SHA256 curl-runner-cli-VERSION-windows-x64.zip).Hash
# Compare with expected hash from SHA256SUMS.txt
# (Manually compare the hash output)Verify Installation
After installation, verify that curl-runner is working correctly:
curl-runner --versionPlatform Support
Linux
Ubuntu 20.04+, CentOS 8+, Alpine Linux
macOS
macOS 11+ (Intel & Apple Silicon)
Windows
Windows 10+, WSL2 supported
Troubleshooting
Common Issues
Command not found
If you get "curl-runner: command not found", ensure that the installation directory is in your PATH.
# Check if curl-runner is in PATH
which curl-runner
# Add to PATH if needed (replace with your installation path)
export PATH="$PATH:~/.bun/bin"Permission denied
On Unix systems, you may need to make the binary executable:
chmod +x /path/to/curl-runnerNext Steps
Now that curl-runner is installed, here's how to get started