Get started

veilens runs entirely on your Mac (Apple Silicon). Install it with the veilens CLI via Homebrew, then point it at a folder of documents. Your data never leaves the machine.

⚠︎ Experimental. veilens is an early research project — not ready to trust with data that truly matters yet.

command line

CLI (Homebrew)

Note: XCode is required, including Metal extensions `xcodebuild -downloadComponent MetalToolchain`

Install the veilens CLI from the tap:

brew install veilensapp/tap/veilens

Then set up the vault and ask:

# engine + weights + headgate + the local site (one time)
veilens install
veilens index ~/vault   # embed your documents on-device
veilens start           # http://localhost:10000
veilens stop            # shut it all down when you're done

# or one-shot from the terminal:
veilens ask "When does my car insurance renew?"

Requirements

A Mac with Apple Silicon (M-series), macOS 14+.
The first veilens install downloads several GB of model weights.
A frontier-model API key (Anthropic) for the code-generation step — optional: with no key, or once a token budget is spent, veilens falls back to the local model. Trusted, free, lower quality — never a hard stop.

New to it? The walkthrough runs the whole flow end to end on a sample vault, and headgate explains why your data stays private.

View veilens on GitHub Source & docs