Download

Fedora / RHEL / Rocky / AlmaLinux (dnf)

Add the Weft repo and install with dnf or yum.

1. Add the repository

$ sudo tee /etc/yum.repos.d/weft.repo <<EOF
[weft]
name=Weft
baseurl=https://weftproject.dev/rpm
gpgcheck=1
gpgkey=https://weftproject.dev/weft-archive-keyring.gpg
enabled=1
EOF

2. Install

$ sudo dnf install weft

3. Verify

$ weft version
weft 0.6.2

Works on Fedora 38+, RHEL 8+, Rocky Linux, AlmaLinux, CentOS Stream. For older systems, use yum instead of dnf.

macOS

One-line install works on both Apple Silicon and Intel Macs.

Recommended

$ curl -fsSL https://weftproject.dev/install.sh | sh

Or download directly

# Apple Silicon (M1/M2/M3/M4)
$ curl -fsSL -o /usr/local/bin/weft \
    https://weftproject.dev/dl/weft-darwin-arm64
$ chmod +x /usr/local/bin/weft

# Intel Mac
$ curl -fsSL -o /usr/local/bin/weft \
    https://weftproject.dev/dl/weft-darwin-amd64
$ chmod +x /usr/local/bin/weft

Homebrew

$ brew tap loreste32/tap
$ brew install weft

Verify

$ weft doctor

Windows

PowerShell (run as Administrator)

PS> New-Item -Path C:\weft -ItemType Directory -Force
PS> Invoke-WebRequest `
    -Uri https://weftproject.dev/dl/weft-windows-amd64.exe `
    -OutFile C:\weft\weft.exe
PS> [Environment]::SetEnvironmentVariable("Path",
    $env:Path + ";C:\weft", "Machine")

Open a new terminal after setting the PATH.

Verify

PS> weft version
weft 0.6.2

PS> weft doctor

From source (with Go installed)

PS> git clone https://github.com/loreste32/weft.git
PS> cd weft
PS> go build -o C:\weft\weft.exe .\cmd\weft

Docker

Run directly

$ docker run --rm ghcr.io/loreste32/weft version
weft 0.6.2

$ docker run --rm -v $(pwd):/app -w /app ghcr.io/loreste32/weft run hello.weft

In a Dockerfile

# multi-stage: build weft, copy binary
FROM golang:1.25-alpine AS build
WORKDIR /src
COPY . .
RUN CGO_ENABLED=0 go build -o /weft ./cmd/weft

FROM alpine:3.20
COPY --from=build /weft /usr/local/bin/weft
COPY app/ /app/
WORKDIR /app
CMD ["weft", "run", "main.weft"]

Or just copy the binary

FROM alpine:3.20
RUN apk add --no-cache ca-certificates
ADD https://weftproject.dev/dl/weft-linux-amd64 /usr/local/bin/weft
RUN chmod +x /usr/local/bin/weft
CMD ["weft", "doctor"]

Build from source

Requires Go 1.25+.

$ git clone https://github.com/loreste32/weft.git
$ cd weft
$ go build -o weft ./cmd/weft
$ ./weft doctor

Install globally

$ sudo cp weft /usr/local/bin/weft
# or
$ make install  # installs to ~/.local/bin/weft

Cross-compile

$ GOOS=linux GOARCH=amd64 go build -o weft-linux ./cmd/weft
$ GOOS=linux GOARCH=arm64 go build -o weft-arm64 ./cmd/weft
$ GOOS=windows GOARCH=amd64 go build -o weft.exe ./cmd/weft

Run tests

$ make test    # 1246 tests across 18 packages
$ make ci      # gofmt, vet, tests, example smoke