Install the CLI
One-liner installer for the Tonbo Artifacts client.
curl -fsSL https://artifacts.tonbo.dev/install.sh | bash
Verify:
artifacts --version
# artifacts version 0.0.1-dev
Running inside Kubernetes (EKS / GKE / AKS / kind)? The pod needs a
privileged container with /dev/fuse exposed before the installer can
mount. See Run in Kubernetes for the full pod spec.
- Platform detection
Refuses anything that isn't
linux-x86_64. v0 ships only this target; macOS and arm64 are on the v1 roadmap. The Mac can still be used as a staging source for Import data. - fuse3 install
Detects
fusermount3inPATH. If missing, installsfuse3via the host's package manager (apt-get,dnf,yum,apk). Usessudoif available; falls back to error if not root and no sudo. - Binary download + verification
Resolves the latest commit SHA from
https://artifacts.tonbo.dev/release/latest-main, downloads the matching binary +.sha256file, verifies the checksum. - Install to PATH
Drops to
/usr/local/bin/artifacts(root) or~/.local/bin/artifacts(non-root). Prints aPATHhint if~/.local/binisn't already on$PATH.
ARTIFACTS_VERSION=8edb2181e222 \
curl -fsSL https://artifacts.tonbo.dev/install.sh | bashUse this for reproducible CI builds or to match what's running in production.
For audit policies or hardened hosts that disallow piping a remote script
to bash:
SHA=$(curl -fsSL https://artifacts.tonbo.dev/release/latest-main)
curl -fsSL "https://artifacts.tonbo.dev/release/$SHA/artifacts" -o /tmp/artifacts
curl -fsSL "https://artifacts.tonbo.dev/release/$SHA/artifacts.sha256" -o /tmp/artifacts.sha256
echo "$(cat /tmp/artifacts.sha256) /tmp/artifacts" | sha256sum -c -
chmod +x /tmp/artifacts
sudo mv /tmp/artifacts /usr/local/bin/artifacts
sudo apt-get install -y fuse3Always sha256-verify before installing. The .sha256 file is
generated by CI alongside the binary and lives at the same release
prefix. The one-liner installer above does this for you; the manual
flow makes it explicit.