Installation

Feynman can be installed either as a standalone runtime bundle or as an npm package. For most users, the standalone installer is the simplest path because it downloads a prebuilt native bundle with zero external runtime dependencies.

On macOS or Linux, open a terminal and run:

curl -fsSL https://feynman.is/install | bash

The installer detects your OS and architecture automatically. On macOS it supports both Intel and Apple Silicon. On Linux it supports x64 and arm64. The launcher is installed to ~/.local/bin, the bundled runtime is unpacked into ~/.local/share/feynman, and your PATH is updated when needed.

If you previously installed Feynman through a package manager and still see local Node.js errors after a curl install, your shell is probably still resolving the older global binary first. Run which -a feynman, then hash -r, or launch the standalone shim directly with ~/.local/bin/feynman.

On Windows, open PowerShell as Administrator and run:

irm https://feynman.is/install.ps1 | iex

This installs the Windows runtime bundle under %LOCALAPPDATA%\Programs\feynman, adds its launcher to your user PATH, and lets you re-run the installer at any time to update.

Alternative: npm install

If you prefer installing Feynman into an existing Node.js environment, use npm instead:

npm install -g @companion-ai/feynman

This path uses your local Node.js runtime instead of the bundled standalone runtime. It requires a compatible Node.js version that satisfies Feynman’s current engine range: >=20.19.0 <25.

Updating the standalone app

To update the standalone Feynman app on macOS, Linux, or Windows, rerun the installer you originally used. That replaces the downloaded runtime bundle with the latest tagged release.

feynman update is different: it updates installed Pi packages inside Feynman’s environment, not the standalone app bundle itself.

If you installed Feynman with npm, upgrade it with:

npm install -g @companion-ai/feynman@latest

Uninstalling

Feynman does not currently ship a dedicated uninstall command. Remove the standalone launcher and runtime bundle directly, then optionally remove the Feynman home directory if you also want to delete settings, sessions, and installed package state. If you also want to clear alphaXiv login state, remove ~/.ahub.

If you installed Feynman with npm, uninstall it with:

npm uninstall -g @companion-ai/feynman

On macOS or Linux:

rm -f ~/.local/bin/feynman
rm -rf ~/.local/share/feynman
# optional: remove settings, sessions, and installed package state
rm -rf ~/.feynman
# optional: remove alphaXiv auth state
rm -rf ~/.ahub

On Windows PowerShell:

Remove-Item "$env:LOCALAPPDATA\\Programs\\feynman" -Recurse -Force
# optional: remove settings, sessions, and installed package state
Remove-Item "$HOME\\.feynman" -Recurse -Force
# optional: remove alphaXiv auth state
Remove-Item "$HOME\\.ahub" -Recurse -Force

If you added the launcher directory to PATH manually, remove that entry as well.

Skills only

If you only want Feynman’s research skills and not the full terminal runtime, install the skill library separately.

For a user-level install into ~/.codex/skills/feynman:

curl -fsSL https://feynman.is/install-skills | bash

For a repo-local install into .agents/skills/feynman under the current repository:

curl -fsSL https://feynman.is/install-skills | bash -s -- --repo

On Windows, install the skills into your Codex skill directory:

irm https://feynman.is/install-skills.ps1 | iex

Or install them repo-locally:

& ([scriptblock]::Create((irm https://feynman.is/install-skills.ps1))) -Scope Repo

These installers download the bundled skills/ and prompts/ trees plus the repo guidance files referenced by those skills. They do not install the Feynman terminal, bundled Node runtime, auth storage, or Pi packages.

Pinned releases

The one-line installer already targets the latest tagged release. To pin an exact version, pass it explicitly:

curl -fsSL https://feynman.is/install | bash -s -- 0.2.24

On Windows:

& ([scriptblock]::Create((irm https://feynman.is/install.ps1))) -Version 0.2.24

Post-install setup

After installation, run the guided setup wizard to configure your model provider and API keys:

feynman setup

This walks you through selecting a default model, authenticating with your provider, and optionally installing extra packages for features like web search and document preview. See the Setup guide for a detailed walkthrough.

Verifying the installation

Confirm Feynman is installed and accessible:

feynman --version

If you see a version number, you are ready to go. Run feynman doctor at any time to diagnose configuration issues, missing dependencies, or authentication problems.