Skip to main content
Almanac requires Python 3.12 or later. Use uv to install the published the-almanac package, which exposes the almanac command.

​
Install uv

If uv --version is not available, install uv with a package manager already on your computer. These commands come from the official uv installation guide:

​
Install

If the command is not found, run:
Use the almanac executable in the directory printed by the first command in your current shell. New terminals will use the PATH updated by the second.

​
Update

almanac update prints the current manual upgrade command. You can also run:

​
Verify the environment

Doctor checks local endpoint configuration, whether credentials exist, the nearest .almanac.yaml directory link, and installed agent guidance. It does not evaluate ALMANAC_ORGANIZATION 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.