Installation

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

# stable release channel
curl -fsSL https://feynman.is/install | bash -s -- stable

# package manager fallback
pnpm add -g @companion-ai/feynman

bun add -g @companion-ai/feynman

The one-line installer tracks the latest main build. Use stable or an exact version to pin a release. 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 | | /outputs | Browse all research artifacts |

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

Skills & Tools

• 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

How it works

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.

Contributing

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

Docs · MIT License