Installation

Install curl-runner on your system using your preferred package manager or download a pre-built binary.

Prerequisites

Mandatory

curl-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 --version

# Install Bun (if not already installed)
curl -fsSL https://bun.sh/install | bash

# Verify Bun installation
bun --version

Recommended

Install using Bun for optimal performance and compatibility.

bun install -g @curl-runner/cli

bun install -g @curl-runner/cli

Install using npm if you prefer Node.js ecosystem tools.

npm install -g @curl-runner/cli

npm install -g @curl-runner/cli

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.

After installation, verify that curl-runner is working correctly:

curl-runner --version

curl-runner --version

Ubuntu 20.04+, CentOS 8+, Alpine Linux

macOS 11+ (Intel & Apple Silicon)

Windows 10+, WSL2 supported

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"

# 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"

On Unix systems, you may need to make the binary executable:

chmod +x /path/to/curl-runner

chmod +x /path/to/curl-runner

Now that curl-runner is installed, here's how to get started

Create and run your first HTTP request in minutes

Learn the configuration file format and structure

Copy-paste examples for common HTTP operations

Complete command-line options and usage guide

On This Page