The open source AI research agent.

macOS / Linux:

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

Windows (PowerShell):

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

The one-line installer fetches the latest tagged release. To pin a version, pass it explicitly, for example curl -fsSL https://feynman.is/install | bash -s -- 0.2.14.

If you install via pnpm or bun instead of the standalone bundle, Feynman requires Node.js 20.19.0 or newer.

If you want just the research skills without the full terminal app:

macOS / Linux:

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

Windows (PowerShell):

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

That installs the skill library into ~/.codex/skills/feynman.

For a repo-local install instead:

macOS / Linux:

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

Windows (PowerShell):

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

That installs into .agents/skills/feynman under the current repository.

$ feynman "what do we know about scaling laws"
→ Searches papers and web, produces a cited research brief

$ feynman deepresearch "mechanistic interpretability"
→ Multi-agent investigation with parallel researchers, synthesis, verification

$ feynman lit "RLHF alternatives"
→ Literature review with consensus, disagreements, open questions

$ feynman audit 2401.12345
→ Compares paper claims against the public codebase

$ feynman replicate "chain-of-thought improves math"
→ Replicates experiments on local or cloud GPUs

Ask naturally or use slash commands as shortcuts.

Four bundled research agents, dispatched automatically.

• Researcher — gather evidence across papers, web, repos, docs
• Reviewer — simulated peer review with severity-graded feedback
• Writer — structured drafts from research notes
• Verifier — inline citations, source URL verification, dead link cleanup

• AlphaXiv — paper search, Q&A, code reading, annotations (via alpha CLI)
• Docker — isolated container execution for safe experiments on your machine
• Web search — Gemini or Perplexity, zero-config default
• Session search — indexed recall across prior research sessions
• Preview — browser and PDF export of generated artifacts
• Modal — serverless GPU compute for burst training and inference
• RunPod — persistent GPU pods with SSH access for long-running experiments

Built on Pi for the agent runtime, alphaXiv for paper search and analysis, and CLI tools for compute and execution. Capabilities are delivered as Pi skills — Markdown instruction files synced to ~/.feynman/agent/skills/ on startup. Every output is source-grounded — claims link to papers, docs, or repos with direct URLs.

git clone https://github.com/getcompanion-ai/feynman.git
cd feynman
nvm use || nvm install
pnpm install
pnpm start

Docs · MIT License