Skip to content
Pilum

Installation

On macOS or Linux:

Terminal window
brew tap sid-technologies/pilum
brew install pilum

From Source

Requires Go 1.25 or later (the version in Pilum’s go.mod):

Terminal window
go install github.com/sid-technologies/pilum@latest

Binaries built this way report their version as dev, because the release version is injected at build time.

Verify Installation

Terminal window
pilum --version

Output:

pilum v0.7.14

The number is whatever release you installed.

Requirements

Pilum doesn’t talk to cloud APIs directly. Each recipe shells out to the provider’s own CLI, so install the tools for the targets you use and authenticate them as you normally would.

Target (type)Tools on PATH
gcp-cloud-run, gcp-cloud-run-job, gcp-artifact-registry-image, gcp-mig-containerdocker, gcloud
gcp-cloud-run-from-imagegcloud
azure-container-appsdocker, az
aws-lambdasam (deploy), aws (pilum status / pilum logs)
cloudflare-pagesnode with npm or pnpm (wrangler runs via npx)
npmnode and your package manager (npm, pnpm, yarn or bun)
homebrewgo, git, tar, shasum

Plus whatever your build.cmd calls (go, cargo, mvn, …).

The Homebrew recipe does not need the GitHub CLI: it clones and pushes the tap with git, using the token named in homebrew.token_env.

Shell Completion

pilum completion generates completion scripts for bash, zsh, fish and PowerShell.

Terminal window
# bash (current session)
source <(pilum completion bash)


# zsh
pilum completion zsh > "${fpath[1]}/_pilum"


# fish
pilum completion fish | source
Terminal window
# PowerShell
pilum completion powershell | Out-String | Invoke-Expression

To load completions in every session, add the line to your shell’s startup file (~/.bashrc, ~/.zshrc, ~/.config/fish/config.fish, or your PowerShell profile).

Next Steps