§ 01 Install ~30s, single binary

One binary. Six platforms. Zero registry account.

phi ships as a single static Go binary. Pick the install method for your platform — they all produce the same phi executable.

Linux

One-liner — detects architecture (amd64 / arm64), downloads the right archive, verifies its sha256, and installs to /usr/local/bin:

curl -sSL https://phi.philtechs.org/install.sh | sh

If you don't have write access to /usr/local/bin, the script sudos. To install elsewhere:

curl -sSL .../install.sh | sh -s -- --dir ~/.local/bin

To pin a specific version:

curl -sSL .../install.sh | sh -s -- --version v0.1.0

macOS

Same script — supports both Intel (x86_64) and Apple Silicon (arm64) Macs:

curl -sSL https://phi.philtechs.org/install.sh | sh

Windows

From PowerShell:

iwr -useb https://phi.philtechs.org/install.ps1 | iex

Installs to %LOCALAPPDATA%\phi\phi.exe. The script tells you whether the install dir is on PATH and prints the setx command to add it if not.

Direct download

Grab the right archive from GitHub Releases and extract it:

PlatformArchive
Linux x86_64 phi_X.Y.Z_Linux_x86_64.tar.gz
Linux arm64 phi_X.Y.Z_Linux_arm64.tar.gz
macOS Intel phi_X.Y.Z_Darwin_x86_64.tar.gz
macOS Apple Siliconphi_X.Y.Z_Darwin_arm64.tar.gz
Windows x86_64 phi_X.Y.Z_Windows_x86_64.zip

Each release also publishes checksums.txt with sha256 hashes — verify before installing.

Build from source

Requires Go 1.21 or later:

git clone https://github.com/philtechs-org/phi
cd phi
go mod tidy
go build -o phi ./cmd/phi

Verify

phi version

Should print phi 0.1.0.

Uninstall

phi is a single binary — delete it and remove its cache:

# Linux / macOS
sudo rm /usr/local/bin/phi
rm -rf ~/.cache/phi

# Windows
Remove-Item "$env:LOCALAPPDATA\phi" -Recurse -Force