albedo docs

Install

Albedo is pre-alpha and runs on Linux and macOS. The Nix package is the easy way: it carries everything Albedo needs. Without Nix you build it from a checkout.

On this page: With Nix, Without Nix, First run, and Optional: code review images.

With Nix

Try it without installing anything:

nix run git+https://tangled.org/okami.mom/albedo

Install it into your profile:

nix profile install git+https://tangled.org/okami.mom/albedo
albedo

The package includes the terminal client, the daemon, the web client, the Python the kernel runs on, and a headless Chrome for browser work.

To declare Albedo in your configuration and run its daemon as a login service, see Manage Albedo with home-manager.

Without Nix

There are no prebuilt packages yet, so this builds from source. You need:

git clone https://tangled.org/okami.mom/albedo
cd albedo
(cd apps/albedo && gleam build)
go -C cli install -ldflags "-X main.buildRoot=$(pwd)" ./cmd/albedo
albedo

go install puts albedo in ~/go/bin, so that directory must be on your PATH. The -ldflags part tells the client where the checkout is, because the daemon runs from it: keep the checkout, and keep gleam on your PATH. If you move the checkout, set ALBEDO_ROOT to its new path.

First run

albedo login   # add a model provider
albedo         # open the terminal client in the current folder

albedo starts the daemon when none is running, and the daemon keeps your agents working after you close the client. albedo daemon --stop stops it. See Daemon attachment and local startup for how the client finds, starts, and replaces a daemon.

From here, open the web client, or run albedo --help for the rest of the commands.

Optional: code review images

The view extension lets an agent review their own changes as highlighted images. It is part of the Nix package. From a checkout it needs cargo:

native/render/install.sh   # then enable view in /extensions

Previous overview Next web client