The open source AI research agent.
Installation
curl -fsSL https://feynman.is/install | bash
# Windows
irm https://feynman.is/install.ps1 | iex
# npm fallback
npm install -g @companion-ai/feynman
Then run feynman setup to configure your model and get started.
What you type → what happens
$ 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
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.
- 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
- Session search — indexed recall across prior research sessions
- Preview — browser and PDF export of generated artifacts
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