Setup

Guided setup

feynman setup

This walks through four steps:

Model provider authentication

Feynman uses Pi’s OAuth system for model access. The setup wizard prompts you to log in to your preferred provider.

feynman model login

AlphaXiv powers Feynman’s paper search and analysis tools. Sign in with:

feynman alpha login

Check status anytime:

feynman alpha status

Web search routing

Feynman supports three web search backends:

auto — Prefer Perplexity when configured, fall back to Gemini
perplexity — Force Perplexity Sonar
gemini — Force Gemini (default, zero-config via signed-in Chromium)

The default path requires no API keys — it uses Gemini Browser via your signed-in Chromium profile.

Preview dependencies

For PDF and HTML export of generated artifacts, Feynman needs pandoc:

feynman --setup-preview

Global macOS installs also try to install pandoc automatically when Homebrew is available. Use the command above to retry manually.

Optional packages

Feynman keeps the default package set lean so first-run installs stay fast. Install the heavier optional packages only when you need them:

feynman packages list
feynman packages install memory
feynman packages install session-search
feynman packages install generative-ui
feynman packages install all-extras

Diagnostics

Run the doctor to check everything:

feynman doctor