Get started

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

⚠︎ Experimental. millfolio 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 mill CLI from the tap:

brew install millfolio/tap/mill

Then set up the vault and ask:

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

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

Requirements

A Mac with Apple Silicon (M-series), macOS 14+.
The first mill 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, millfolio 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 the privacy box explains why your data stays private.

View millfolio on GitHub Source & docs