Skip to main content
HTTPSpec is distributed as pre-built binaries for all major platforms. Download the appropriate binary for your system and add it to your PATH.

​
Download Pre-built Binaries

1

Choose your platform

Select the correct binary for your operating system and architecture:
binary="httpspec_linux_arm"
2

Download the latest release

Use curl to download the binary from GitHub releases:
# Download the binary (replace $binary with your platform)
curl -L -o httpspec https://github.com/bradcypert/httpspec/releases/latest/download/$binary
This downloads the latest version and saves it as httpspec in your current directory.
3

Make the binary executable

On Linux and macOS, you need to set executable permissions:
chmod 744 httpspec
Windows users can skip this step.
4

Add to PATH

Move the binary to a directory in your PATH. On Linux and macOS:
mv httpspec /usr/local/bin
On Windows, you can:
  • Move httpspec.exe to C:\Windows\System32, or
  • Add the directory containing httpspec.exe to your PATH environment variable
Make sure /usr/local/bin (or your chosen directory) is in your PATH. You can verify this by running echo $PATH.
5

Verify installation

Confirm HTTPSpec is installed correctly:
httpspec --help
You should see the help output showing available options.

​
Complete Installation Example

Do not blindly copy/paste this script. Read it and run only the parts that apply to your system.
# Use the appropriate binary for your OS and Arch
binary="httpspec_linux_arm"    # linux arm
binary="httpspec_linux_x86"    # linux x86
binary="httpspec_mac_arm"      # mac arm 
binary="httpspec_mac_x86"      # mac x86
binary="httpspec_windows_x86"  # windows

# curl, follow redirects, output to "httpspec", download target latest release
curl -L -o httpspec https://github.com/bradcypert/httpspec/releases/latest/download/$binary

# You _may_ need to update permissions for httpspec
chmod 744 httpspec

# You probably also want to move this to a place that exists in your path
mv httpspec /usr/local/bin

​
Building from Source

If you prefer to build HTTPSpec from source, you’ll need the Zig compiler.
1

Install Zig

HTTPSpec is written in Zig. Download and install Zig from ziglang.org.The project specifies the required Zig version in .tool-versions.
2

Clone the repository

git clone https://github.com/bradcypert/httpspec.git
cd httpspec
3

Build the project

zig build
This compiles HTTPSpec and places the binary in zig-out/bin/httpspec.
4

Install the binary

zig build install
Or manually copy the binary to your PATH:
cp zig-out/bin/httpspec /usr/local/bin/

​
Next Steps

Now that HTTPSpec is installed, you’re ready to create your first test!

Quick Start Guide

Learn how to create and run your first HTTPSpec test

Build docs developers (and LLMs) love

Get started for freeTalk to us