Install

Beam is distributed as a single binary. The official installer fetches the latest stable release, verifies SHA-256, and aborts on mismatch.

One-line install

Run this in any terminal:

$ curl -fsSL https://install.beam.payy.network | bash

Supported platforms:

linux-x86_64
macos-x86_64
macos-aarch64

The script selects the newest stable release that includes an asset for your platform and a valid GitHub Release SHA-256 digest, then verifies the downloaded binary against that digest before installing.

Pin a specific version

$ curl -fsSL https://install.beam.payy.network | bash -s -- 0.1.1

The installer rejects versions without a matching release asset for your platform.

Verify the install

After the script finishes, confirm the binary is on your PATH:

$ beam --version
beam 0.1.1
$ beam --help

Local development

Building from source requires the standard Rust toolchain and uses the workspace at pkg/beam-cli/:

$ git clone https://github.com/polybase/payy
$ cd payy
$ cargo run -p beam-cli -- --help

Local builds use the bb CLI backend for privacy operations by default. Release binaries are built with the bundled Barretenberg bindings, so privacy operations on a public release do not require a local bb executable.

Where it lives

The installer writes Beam state under $BEAM_HOME (defaulting to ~/.beam):

Path	Purpose
`~/.beam/wallets/`	Encrypted keystores
`~/.beam/chains.json`	Chain config + privacy profiles
`~/.beam/tokens.json`	Tracked ERC20 tokens
`~/.beam/privacy/`	Resume cache for private operations
`~/.beam/history`	REPL history (sanitized)