Building From Source CLI

Building the Photosphere CLI from Source

This guide is for developers who want to build the psi CLI from source. Most users should install a published release instead. See Installation-CLI.

Prerequisites

• Bun
• Git
• The media processing tools FFmpeg and ImageMagick (see Required-Tools)

Build

# Clone the repository
git clone git@github.com:ashleydavis/photosphere.git
cd photosphere

# Install dependencies (from the repo root)
bun install

# Build the CLI for your platform (from apps/cli)
cd apps/cli
bun run build-linux         # Linux x64
bun run build-win           # Windows x64
bun run build-win-baseline  # Windows x64 (older CPUs)
bun run build-mac-x64       # macOS Intel
bun run build-mac-arm64     # macOS Apple Silicon

The compiled psi binary is written under apps/cli/bin/ (for example apps/cli/bin/x64/linux/psi).

Run without building

To run the CLI directly from source without compiling a binary (from apps/cli):

bun run start -- <command> [options]

Next Steps

• Getting-Started-CLI - Using the CLI
• Command-Reference - Full command reference