Skip to main content
Almanac requires Python 3.12 or later. The installer uses uv to install the the-almanac package and exposes the almanac command.

​
Install

curl -fsSL https://usealmanac.com/install.sh | sh
almanac --version
If the command is not found, open a new shell so its tool directory is on your PATH.

​
Install with uv directly

uv tool install the-almanac

​
Update

almanac update
almanac update prints the current manual upgrade command. You can also run: 
uv tool install --upgrade the-almanac

​
Verify the environment

almanac doctor
Doctor checks local endpoint configuration, whether credentials exist, the nearest .almanac.yaml directory link, and installed agent guidance. It does not evaluate ALMANAC_WIKI or an explicit command flag. Run almanac whoami to verify the credential against the hosted service. Continue with Sign in, or run the complete first-wiki tutorial.