Feynman

The open source AI research agent

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

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

Or install the npm fallback:

npm install -g @companion-ai/feynman

feynman setup
feynman

Feynman works directly inside your folder or repo. For long-running work, keep the stable repo contract in AGENTS.md, the current task brief in outputs/.plans/, and the chronological lab notebook in CHANGELOG.md.

What you type → what happens

Prompt	Result
`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"`	Asks where to run, then builds a replication plan
`feynman "summarize this PDF" --prompt paper.pdf`	One-shot mode, no REPL

Workflows

Ask naturally or use slash commands as shortcuts.

Command	What it does
`/deepresearch <topic>`	Source-heavy multi-agent investigation
`/lit <topic>`	Literature review from paper search and primary sources
`/review <artifact>`	Simulated peer review with severity and revision plan
`/audit <item>`	Paper vs. codebase mismatch audit
`/replicate <paper>`	Replication plan with environment selection
`/compare <topic>`	Source comparison matrix
`/draft <topic>`	Paper-style draft from research findings
`/autoresearch <idea>`	Autonomous experiment loop
`/watch <topic>`	Recurring research watch

Agents

Four bundled research agents, dispatched automatically or via subagent commands.

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

Tools

AlphaXiv — paper search, Q&A, code reading, persistent annotations
Docker — isolated container execution for safe experiments on your machine
Web search — Gemini or Perplexity, zero-config default via signed-in Chromium
Session search — optional indexed recall across prior research sessions
Preview — browser and PDF export of generated artifacts

CLI

feynman                             # REPL
feynman setup                       # guided setup
feynman doctor                      # diagnose everything
feynman status                      # current config summary
feynman model login [provider]      # model auth
feynman model set <provider/model>  # set default model
feynman alpha login                 # alphaXiv auth
feynman packages list               # core vs optional packages
feynman packages install memory     # opt into heavier packages on demand
feynman search status               # web search config

How it works

Built on Pi for the agent runtime, alphaXiv for paper search and analysis, and Docker for isolated local execution

Every output is source-grounded — claims link to papers, docs, or repos with direct URLs

Contributing

git clone https://github.com/getcompanion-ai/feynman.git
cd feynman && npm install && npm run start

Docs · MIT License

3.7 KiB Raw Blame History