Install

One binary CLI (cellp) plus celld, offshoot, and esbuild. No Docker required for local cellp dev.

One-liner (macOS / Linux)

curl -fsSL https://raw.githubusercontent.com/KonghaYao/cellp/main/scripts/install.sh | sh

Puts cellp, cellpd, celld, offshoot, and esbuild in ~/.local/bin. Then:

export PATH="$HOME/.local/bin:$PATH"
cellp doctor
cellp dev

Override install location: CELLP_INSTALL_DIR=/usr/local/bin curl -fsSL … | sh

Pin a release: CELLP_VERSION=v0.1.0 curl -fsSL … | sh

If the GitHub API rate-limits you, set GH_TOKEN (a fine-grained or classic token with contents: read).

What you get

Binary	Role
cellp	CLI: dev (local platform), serve (env-based cellpd), doctor
celld	Workers runtime (spawned per version)
offshoot	SQLite copy-on-write for App + Data
cellpd	Same process as cellp serve (Compose / systemd)
esbuild	Bundler used by celld deploy (included in the release tarball)

Overview of how these fit together: Architecture at a glance.

GitHub Releases

Cross-platform archives are published on version tags (v*):

https://github.com/KonghaYao/cellp/releases

Names: cellp_<tag>_<os>_<arch>.tar.gz for linux/darwin × amd64/arm64.

Native Windows is not shipped yet (celld is Unix). Use WSL2, macOS, Linux, or Docker.

Docker

Production-shaped stack (RustFS + cellpd image): Self-hosting · ghcr.io/konghayo/cellp.

From source

git clone https://github.com/KonghaYao/cellp.git && cd cellp
git submodule update --init celld
cd cellp && go build -o cellp ./cmd/cellp
cd ../celld && cargo build -p celld --profile lab

For a Docker-based laptop stack with RustFS, use ./dev/scripts/up.sh (see Local stack).