Feynman: Multi-agent scientific research with citations
An AI research agent for developers that connects paper search, review, writing, and citation checks through built-in Pi workflows.
GitHub advaitpaliwal/feynman Updated 2026-09-08 Branch main Stars 9.0K Forks 1.0K
TypeScript AI research agent Pi alphaXiv macOS/Linux/Windows

🧭 Decision Guide

Try it if you

  • You need /deepresearch or /lit to organize papers and primary sources
    The README's Workflows section lists /deepresearch and /lit; the Agents section says Researcher gathers paper evidence
  • You want to check citation URLs and dead links with verifier-style capabilities
    The README's Agents section says Verifier handles inline citations, source URL verification, and dead-link cleanup
  • You already run local model services through LM Studio, LiteLLM, Ollama, or vLLM
    The README's Installation section lists these local-model integrations and /v1 endpoints

Skip it if you

  • You require explicit guarantees about model quality, cost, or workflow performance
    The provided README material contains no model, cost, or performance benchmarks
  • You cannot accept installing the latest tagged release through curl or PowerShell
    The macOS/Linux and Windows installation commands in Installation fetch the latest tagged release
  • You only need standalone skills and do not use Codex, Claude, or OpenCode
    The Skills Only section only describes installation into ~/.codex/skills/feynman, .agents/skills/feynman, or .opencode/skills/feynman

Requirements

  • Use the curl installation command on macOS/Linux and the PowerShell installation command on Windows
  • The standalone installation includes its own pinned Node.js runtime
  • Local-model integration requires the README settings for LM Studio at http://localhost:1234/v1, LiteLLM at http://localhost:4000/v1, or the local /v1 endpoint for Ollama/vLLM
  • Use feynman model login for hosted-provider authentication; OpenRouter also supports OPENROUTER_API_KEY

First step (verbatim from README)

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

Watch out

  • Rerun the installer to upgrade the standalone app; feynman update alone is insufficient
    The Installation section explicitly says feynman update does not replace the standalone runtime bundle
  • Removing ~/.feynman also affects settings, sessions, and installed package state
    The uninstall instructions in Installation list settings, sessions, and installed package state under ~/.feynman
  • Skills Only installation does not install the terminal, Node runtime, authentication storage, or Pi packages
    The installer description in the Skills Only section

Alternatives

  • npm installation:You want to use the local Node.js runtime instead of the standalone bundle's pinned Node.js runtime
    Installation
  • Skills Only:You only need research skills in Codex, Claude, or OpenCode and do not need the Feynman terminal
    Skills Only

Not stated in the README

  • The README does not specify the supported Node.js versions
  • The README does not specify fees for hosted model providers, alphaXiv, or external APIs
  • The README does not provide exact model configurations for Researcher, Reviewer, Writer, and Verifier
  • The README does not provide concurrency, latency, or research-quality benchmarks
  • The README does not explain which paper search, URL verification, or source-fetching features remain available offline

💡 Deep Analysis

6
Yes I already use Codex, Claude, or OpenCode inside repositories and do not want to install the Feynman terminal, Node runtime, authentication storage, or Pi packages. Is the skills-only installation sufficient?
For: A developer integrating research capabilities into Codex, Claude, or OpenCode repository environments who prefers skills-only installation over the full terminal app

Yes, if your goal is to embed research skills into an existing agent rather than use the full terminal application or science workbench.

  • The README explicitly says the skills-only installer does not install the Feynman terminal, bundled Node runtime, authentication storage, or Pi packages.
  • Codex skills can be installed under ~/.codex/skills/feynman; repository-local Claude/agent skills go under .agents/skills/feynman.
  • OpenCode has a separate .opencode/skills/feynman target for project-local installation.
  • The installation includes the bundled skills/ and prompts/ trees plus referenced repository guidance files. This reuses research capabilities but is not equivalent to the full session, workbench, Notebook, compute, or file-management experience.

If you need feynman serve, workbench state, or the complete Pi runtime, skills-only is insufficient.

  • Skills Only: does not install the Feynman terminal, bundled Node runtime, auth storage, or Pi packages
  • Skills Only: Codex target is `~/.codex/skills/feynman`
  • Skills Only: repo-local Claude/agent target is `.agents/skills/feynman`
  • Skills Only: OpenCode target is `.opencode/skills/feynman`
curl -fsSL https://feynman.is/install-skills | bash -s -- --codex
Not stated in the README:The README does not list exactly which slash commands are exposed in skills-only mode or whether behavior differs across hosts.;It does not state whether skills-only persists workbench provenance, lineage, and outputs state.
Yes I do not want differences in team members’ local Node.js versions to affect Feynman, but I also need to pin a specific release. Should I use the standalone native bundle or npm installation?
For: A research engineer on macOS or Linux who maintains a local Node.js toolchain and needs a pinned runtime version

Yes. Prefer the standalone native bundle because it includes a pinned Node.js runtime and supports explicit release pinning; npm installation depends on the machine’s local Node.js.

  • On macOS/Linux, the installer downloads a standalone native bundle with its own pinned Node.js runtime.
  • Before replacing an existing installation, it verifies the release SHA-256, which supports deployment processes that require package-integrity checks.
  • The README allows explicit version pinning, for example curl -fsSL https://feynman.is/install | bash -s -- 0.2.35.
  • The npm alternative uses the local Node.js runtime. Also, feynman update refreshes only Pi packages and does not replace the standalone runtime bundle, so upgrade responsibilities differ.

Choose standalone when runtime consistency matters. npm is more natural only when the team already centrally manages Node.js and npm-based distribution.

  • Installation: standalone native bundle with its own pinned Node.js runtime
  • Installation: verifies the release SHA-256 before replacing an existing installation
  • Installation: explicit version pinning is supported, with example `curl -fsSL https://feynman.is/install | bash -s -- 0.2.35`
  • Installation: `feynman update` only refreshes installed Pi packages and does not replace the standalone runtime bundle
  • Project data: latest_release is `v0.3.48`
curl -fsSL https://feynman.is/install | bash
Not stated in the README:The README does not provide the exact Node.js version or list all operating systems and CPU architectures supported by the standalone bundle.;It does not state whether skills, Pi packages, and workbench state remain compatible when an older release is pinned.
Yes We use arXiv papers and code repositories to select ML training approaches, and we need to check whether paper claims match implementations. Is Feynman suitable for a workflow built around `/audit`, `/replicate`, and `/recipe`?
For: A machine-learning team evaluating papers, code repositories, and reproducibility, working mainly with arXiv papers, GitHub code, and ML training recipes

Yes. It is suitable because it combines paper analysis, paper-to-code auditing, replication planning, and ML training-recipe ranking in one research-agent environment.

  • /audit is explicitly described as a “Paper vs. codebase mismatch audit,” so it can compare claims with implementation details.
  • /replicate plans replication checks, but execution happens only after an environment is chosen; it is not an unconditional one-click reproduction system.
  • /recipe ranks ML training recipes by dataset, method, code, and verification status, which fits candidate-method screening.
  • Paper resolution accepts DOI, arXiv ID, OpenAlex ID, PMID, PMCID, or title, with OpenAlex, arXiv/alphaXiv, DOI, and Europe PMC sources.

You still need to verify whether the target repository’s language, dependencies, hardware, and execution model are supported by the available compute and Files environment.

  • Workflows: `/audit`: Paper vs. codebase mismatch audit
  • Workflows: `/replicate`: Plan replication checks; execute only after choosing an environment
  • Workflows: `/recipe`: Ranked ML training recipes with dataset, method, code, and verification status
  • Workflows: `feynman paper`: supports DOI, arXiv ID, OpenAlex ID, PMID, PMCID, or title
feynman paper 
Not stated in the README:The README does not specify supported programming languages, GPU models, container runtimes, or dependency managers.;It does not explain how private-repository authentication or restricted dataset downloads are handled.
It depends I want an agent to run bounded experiment loops with `/autoresearch` based on benchmark evidence, using compute or cloud-backed artifact contexts for results. Is Feynman suitable for executing this directly?
For: An ML engineer who wants an agent to run bounded experiment loops using `/autoresearch`, compute, and local or cloud-backed artifact environments

It depends. Feynman explicitly provides a bounded experiment loop and compute-related workbench capabilities, but the README does not guarantee that arbitrary projects execute out of the box or provide default resource, permission, and stopping policies.

  • /autoresearch is described as a “Bounded experiment loop with benchmark evidence,” directly matching benchmark-driven iteration.
  • feynman serve includes compute, Files host inventory, and local, SSH/BYOC, and cloud-backed artifact contexts.
  • The workbench ledger includes compute egress, Modal environment fields, and compute poller lease state, indicating awareness of compute-task state management.
  • Project insights warn that autoresearch, compute, and code execution may consume resources, pollute environments, or cause side effects. The stated limitations also tie execution to dependencies, hardware, containers, or remote-environment configuration.

It fits an ML workflow with a controlled execution environment, but not treating an arbitrary repository as a safe autonomous experimentation platform.

  • Workflows: `/autoresearch` is a bounded experiment loop with benchmark evidence
  • Workflows: `feynman serve` includes compute, Files host inventory, local, SSH/BYOC, and cloud-backed artifact contexts
  • Workflows: the workbench ledger includes compute egress, Modal environment fields, and compute poller lease state
  • Project insight: autoresearch, compute, and code execution may cause resource use, environment pollution, or side effects
  • Project insight: computation and replication depend on local dependencies, hardware, containers, or remote-environment configuration
feynman serve
Not stated in the README:The README does not specify `/autoresearch` stopping conditions, budget controls, maximum runtime, or default write permissions.;It does not specify supported cloud providers, container images, GPU types, or experiment-sandbox isolation mechanisms.
It depends I do not want to send research material to hosted model providers, but our team already runs LM Studio, Ollama, and vLLM. Can I use Feynman’s local-model integrations for `/lit`, `/review`, and `/draft`?
For: A research engineer handling sensitive research material who wants local models and already has LM Studio, Ollama, or vLLM available

It depends. Model inference can use local services, but literature search and source retrieval may still require external network access, so local inference alone does not guarantee a fully offline workflow.

  • The README explicitly supports LM Studio with the default endpoint http://localhost:1234/v1; LiteLLM uses http://localhost:4000/v1 by default.
  • Ollama and vLLM can be configured through Custom provider, openai-completions, and a local /v1 endpoint.
  • /lit, /review, and /draft cover literature review, research review, and paper-style drafting from findings.
  • However, the project uses OpenAlex, arXiv/alphaXiv, DOI, and Europe PMC sources; the README does not promise that these work without network access.

If all material, credentials, and sources must remain inside an isolated network, applicability depends on whether you can provide local source copies and a supported access path.

  • Installation: Local models are supported through the setup flow
  • Installation: LM Studio uses `http://localhost:1234/v1`; LiteLLM uses `http://localhost:4000/v1` by default
  • Installation: Ollama or vLLM use `openai-completions` and a local `/v1` endpoint
  • Workflows: purposes of `/lit`, `/review`, and `/draft`
  • Project insight: external paper services and network retrieval may not fit fully offline environments
feynman setup
Not stated in the README:The README does not specify whether workbench state, source caches, or logs are sent externally or which local directories store them.;It does not specify required context windows, tool-calling capabilities, or minimum hardware for local models.
It depends I need more than a one-off literature summary: I need projects, sessions, notebooks, compute, files, sources, and lineage. Is `feynman serve` suitable as a long-term research workbench?
For: A researcher who needs persistent management of projects, sessions, research artifacts, and experiment records and plans to use the Feynman science workbench

It depends. The feature coverage matches long-running research-record needs, but the project’s release data and stated limitations indicate that some workbench and scientific-tool capabilities may still be evolving quickly.

  • feynman serve provides project/session navigation, notebooks, compute, Files host inventory, sources, settings, lineage, and provenance.
  • It also supports previews for audio/video, spreadsheets, notebooks, LaTeX, and scientific artifacts, plus artifact Notes and note-preview modals.
  • Workbench state is stored under ~/.feynman/orgs//workbench, with a feynman-workbench.db mirror, which fits structured research records.
  • However, the latest release is v0.3.48 and the project has 5 releases; the README does not promise upgrade compatibility, backup/restore, multi-user collaboration, or data migration.

It is therefore suitable for individual or small-scope continuing research, but the available information is insufficient for mature team governance and defined data lifecycle requirements.

  • Workflows: `feynman serve` includes project/session navigation, Notebook, compute, Files, lineage, provenance, and scientific-file previews
  • Workflows: workbench state is under `~/.feynman/orgs//workbench`, including `feynman-workbench.db`
  • Project data: latest release is `v0.3.48`; release_count is `5`
  • Project insight: the maturity of some workbench and scientific-tool capabilities cannot be confirmed from the README alone
feynman serve
Not stated in the README:The README does not describe backup, restore, migration, or concurrent-access behavior for the workbench database.;It does not fully specify organization-level permissions, audit logs, multi-user collaboration, or the security boundary of cloud connectors.

✨ Highlights

  • Researcher covers papers, web pages, repositories, and docs
  • Verifier provides inline citations, URL verification, and dead-link cleanup
  • Supports /deepresearch, /lit, and /replicate workflows
  • Has 9,042 stars, 1,042 forks, and latest version v0.3.48

🔧 Engineering

  • Researcher, Reviewer, Writer, and Verifier form four research agents
  • PaperRank scores evidence to decide which papers to read first
  • The paper command supports DOI, arXiv, PMID, and OpenAlex IDs
  • serve provides a science workbench, notebooks, compute, and artifact previews

⚠️ Risks

  • The standalone installer downloads and replaces the standalone runtime bundle
  • feynman update refreshes Pi packages, not the standalone runtime bundle
  • OpenRouter over SSH requires pasting a callback URL or setting an API key
  • The README provides no model, cost, or performance data for the workflows

👥 For who?

  • Research developers who need evidence chains across papers, web, and repositories
  • Engineers using Codex, Claude, or OpenCode skill directories
  • Users needing integration with LM Studio, LiteLLM, Ollama, or vLLM