The open source AI research agent.
macOS / Linux:
curl -fsSL https://feynman.is/install | bashWindows (PowerShell):
irm https://feynman.is/install.ps1 | iexThe 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.17.
The installer downloads a standalone native bundle with its own Node.js runtime.
To upgrade the standalone app later, rerun the installer. feynman update only refreshes installed Pi packages inside Feynman's environment; it does not replace the standalone runtime bundle itself.
To uninstall the standalone app, remove the launcher and runtime bundle, then optionally remove ~/.feynman if you also want to delete settings, sessions, and installed package state. If you also want to delete alphaXiv login state, remove ~/.ahub. See the installation guide for platform-specific paths.
Local models are supported through the custom-provider flow. For Ollama, run feynman setup, choose Custom provider (baseUrl + API key), use openai-completions, and point it at http://localhost:11434/v1.
If you want just the research skills without the full terminal app:
macOS / Linux:
curl -fsSL https://feynman.is/install-skills | bashWindows (PowerShell):
irm https://feynman.is/install-skills.ps1 | iexThat 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 -- --repoWindows (PowerShell):
& ([scriptblock]::Create((irm https://feynman.is/install-skills.ps1))) -Scope RepoThat installs into .agents/skills/feynman under the current repository.
These installers download the bundled skills/ and prompts/ trees plus the repo guidance files referenced by those skills. They do not install the Feynman terminal, bundled Node runtime, auth storage, or Pi packages.
$ 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.
| 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> |
Replicate experiments on local or cloud GPUs |
/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 |
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
alphaCLI) - 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.
See CONTRIBUTING.md for the full contributor guide.
git clone https://github.com/getcompanion-ai/feynman.git
cd feynman
nvm use || nvm install
npm install
npm test
npm run typecheck
npm run build