Skip to main content
Almanac is a hosted source library and wiki. You give it files; Almanac keeps the originals, writes readable pages, and shows the job that produced each update.
Files enter a durable source library, become readable cited pages, and are updated by observable jobs.

​
Three things to remember

Sources are evidence

Original bytes and filenames remain available after Almanac organizes the library.

Pages are the reading layer

Searchable articles synthesize the source library and cite it.

Jobs make change visible

Upload and Garden work has a status, event history, summary, and outcome.

​
The ownership hierarchy

An Organization owns membership, billing, keys, and exactly one Wiki. The Wiki is the knowledge layer you search and maintain. CLI and SDK users identify the Organization by ID or slug; direct REST routes use its ID.

​
What happens after an upload

The CLI discovers files and uploads them to the hosted source library. If at least one file is new, Almanac creates one ingest job. That job reads the changed evidence and updates wiki pages. Uploading only duplicates can finish without a new job. The source library remains valuable even before a page is written: it is the durable evidence layer. See Sources, pages, and citations for the deeper model.

Build the model once

Link an Organization, upload files, follow the job, then trace a page to its sources.