Installation#

Zerfoo requires Go 1.26 or later. Download Go if you haven’t already.

Verify your Go installation:

go version
# go version go1.26.1 linux/amd64

As a Library#

Add Zerfoo to your Go module:

go get github.com/zerfoo/zerfoo@latest

Then import it in your code:

import "github.com/zerfoo/zerfoo"

For just tensors and GPU compute, import github.com/zerfoo/ztensor. For just tokenization, import github.com/zerfoo/ztoken.

CLI#

Install the zerfoo command-line tool:

go install github.com/zerfoo/zerfoo/cmd/zerfoo@latest

This places the zerfoo binary in your $GOPATH/bin (or $HOME/go/bin by default). Make sure this directory is in your PATH.

Build from Source#

git clone https://github.com/zerfoo/zerfoo.git
cd zerfoo
go build -o zerfoo ./cmd/zerfoo

Zerfoo builds with zero CGo by default (CGO_ENABLED=0). GPU acceleration is loaded dynamically at runtime via purego/dlopen, so you do not need CUDA headers, shared libraries, or build tags to compile. A plain go build produces a fully static binary.

Platform Support#

Zerfoo compiles on any platform supported by Go 1.26, including Linux, macOS, and Windows.

GPU acceleration is available on:

For GPU setup instructions, see GPU Setup.

Verify Installation#

Library#

Create a test file to confirm the library is importable:

mkdir zerfoo-test && cd zerfoo-test
go mod init zerfoo-test
go get github.com/zerfoo/zerfoo@latest

package main

import (
	"fmt"
	"github.com/zerfoo/zerfoo"
)

func main() {
	fmt.Println("zerfoo imported successfully")
	_ = zerfoo.Load
}

go run main.go
# zerfoo imported successfully

CLI#

zerfoo version

This prints the installed version. If the command is not found, ensure $GOPATH/bin is in your PATH:

export PATH="$PATH:$(go env GOPATH)/bin"

Next Steps#

• Quickstart – pull a model and run your first inference
• GPU Setup – configure CUDA, ROCm, or OpenCL for hardware-accelerated inference