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:
- Gleam 1.19 or newer, with Erlang/OTP 29
- Go 1.26 or newer
- Python 3.11 or newer
- Node.js, only for the web client
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