macOS

Prerequisites

Docker Desktop, running. It bundles Compose v2, and works the same on Apple Silicon and Intel — the images are published multi-arch (linux/amd64 and linux/arm64), so there’s no emulation on an M-series Mac.

Nothing else is needed: no Python, no Homebrew packages, no source checkout.

Install

export ANTHROPIC_API_KEY=sk-ant-...
curl -sSL https://raw.githubusercontent.com/bantex01/VectorStep-Dist/main/install.sh | bash

Everything lands in ~/.vectorstep/, with pipelines/, steps/, and agents/ as ordinary directories you can open in any editor — they’re mounted into the containers, so a saved file is picked up without a rebuild.

Add --service-only if the Gateway runs elsewhere or you drive VectorStep with OpenClaw. Re-run the installer to upgrade; it never overwrites your config, .env, or authored files.

Day-to-day

cd ~/.vectorstep
docker compose ps
docker compose logs -f vectorstep
docker compose up -d          # apply a config change
docker compose down           # stop, keeping data

Notes specific to macOS

• Docker Desktop must be running before the installer will work; it will tell you plainly if it isn’t.
• Ports. VectorStep binds 8000 on localhost. The Gateway’s 18780 is not published to the host by default — vectorstep reaches it over the compose network only; see Reaching the Gateway from the host if you need it directly. If 8000 clashes with something else, change VECTORSTEP_PORT in ~/.vectorstep/.env and re-run docker compose up -d.
• There is no launchd path. The services are declared restart: unless-stopped, so they come back when Docker Desktop starts. If you want them up at login, enable Docker Desktop’s own “Start when you log in” setting.

This page is kept separate from Linux rather than being a pointer to it, because Apple Silicon packaging quirks or a native launchd path could land here later without restructuring anything.