Getting Started
Introduction
Augur is a small, real programming language with one twist: the interpreter is 100% deterministic, but the operations themselves are divined by an LLM instead of computed.
Lexer, parser, scope, control flow, and function calls are an ordinary, deterministic tree-walking evaluator. But the operations — arithmetic, comparison, collection transforms, even HTTP and the database — descend to an oracle (an LLM) that decides what the result should be. A meme premise on a serious architecture. 2 + 2 is whatever the oracle says it is — unless you wrap it in certain { }, where it is real, native, free, and always 4.
oracle "anthropic"
summon secret = divine "pick a random number from 1 to 100"
summon guess = ask "Your guess: "
when guess == secret -> proclaim "You got it!"
otherwise -> proclaim "Try again."
The premise
Every operation runs in one of three zones on a confidence gradient: divine (the default — through the AI), chaos (high temperature, anarchy), and certain (real, native, deterministic). The golden rule: control flow and scope are always deterministic; the oracle only decides whether each step's result is right, never what is computable.
filter/extract/classify, typed coercion, vibe-tests) turns out to be handy.Next
Head to Installation to get it running, then The Confidence Gradient for the core idea.