9b1e04f128
- TUI header now shows CPU cores, RAM, GPU, and Docker availability - System prompt uses resource info to recommend execution environments - Docker skill for running experiment code in isolated containers - Renamed docker-sandbox skill to docker (Feynman stays on host, code runs in containers) - Updated README and website to cite Docker alongside Agent Computer Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Feynman
The open source AI research agent
npm install -g @companion-ai/feynman
feynman setup
feynman
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
- Agent Computer — secure cloud execution for long-running research and GPU workloads
- Web search — Gemini or Perplexity, zero-config default via signed-in Chromium
- Session search — 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 search status # web search config
How it works
Built on Pi for the agent runtime, alphaXiv for paper search and analysis, Docker for isolated local execution, and Agent Computer for secure cloud workloads
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