v0.1.2 now available

Deploy all your services with one command.

Like the Roman javelin — one throw, every target.

$

Who It's For

Startups

Move fast, deploy faster. No custom CI/CD required.

Enterprises

Standardize everything. One config format across all teams, all clouds.

Multi-cloud teams

Cloud-agnostic configs. Same service.yaml deploys to GCP, AWS, or Azure.

Solo developers

Just pilum deploy. Stop copy-pasting deploy scripts.

How It Works

1

Add config

Drop a service.yaml in each service directory

2

Deploy

Run pilum deploy from your project root

3

Done

All services deployed in parallel to their targets

Supported Targets

One throw, multiple targets. More coming soon.

GCP Cloud Run
Homebrew
AWS Lambda Coming soon
Docker Registry Planned
Kubernetes Planned
Azure Planned

Simple Configuration

Drop a service.yaml in each service directory. Run pilum deploy. Done.

Real examples from production.

GCP Cloud Run
service.yaml
# Deploy API to Cloud Run
name: api-gateway
type: gcp-cloud-run
project: my-gcp-project
region: us-central1

build:
  language: go
  version: "1.23"
  env_vars:
    CGO_ENABLED: "0"
    GOOS: linux
    GOARCH: amd64

env_vars:
  LOG_LEVEL: info
  ENV: production

secrets:
  DATABASE_URL: projects/my-gcp-project/secrets/db-url
Homebrew
service.yaml
# Pilum deploys itself
name: pilum
type: homebrew
description: Multi-cloud deployment CLI
license: BSL-1.1

homebrew:
  project_url: https://github.com/SID-Technologies/pilum
  tap_url: https://github.com/SID-Technologies/Homebrew-Pilum
  token_env: GH_TOKEN

build:
  language: go
  version: "1.23"
  output: dist/pilum
  env_vars:
    CGO_ENABLED: "0"
  platforms:
    - os: darwin
      arch: amd64
    - os: darwin
      arch: arm64
    - os: linux
      arch: amd64

Join the Legion

Arm yourself in seconds.

Homebrew
brew tap sid-technologies/pilum && brew install pilum
Read the field manual

Used in production by

Torch
Pilum (deploys itself)
Open Source

Built in the Open

Pilum is free forever. Contributions welcome.

The Roman Javelin

The pilum was the iconic javelin of the Roman legions. Designed with a long iron shank and weighted tip, it was engineered for one purpose: to be thrown once and hit the target with devastating precision.

Upon impact, the soft iron shank would bend, rendering the enemy's shield useless and impossible to throw back. One weapon. One throw. Mission accomplished.

Like its namesake, Pilum is designed to hit your deployment targets precisely, every time.