mrkeyoor.com_
Mon 07 Sept 15:56 UTC
AI Toolsevaluationupdated 07 Sept 2026

feynman review

Feynman is an MIT-licensed AI research agent that searches papers and the web, ranks literature, checks claims against code, and produces cited research briefs. It runs as a terminal app or local science workbench, with separate research skills available for Codex and repository-based agents.

Verdict

Our Feynman run installed 985 packages and used 1,329 MB, then its tests failed after 699 seconds, so this is a serious research workspace rather than a lightweight paper-search utility. The 27-second build and zero-advisory audit support a trial, but the failing assertion and rapid release corrections argue for a pinned version and a local acceptance suite. Use it when one terminal needs to cover papers, web sources, code, and scientific artifacts, with a researcher checking what the agent concludes.

We ran it

Lab card: what happened when we ran feynmanScreenshot of feynman (feynman.is)
Install✓ · 76s985 packages · 1329 MB
Build✓ · 27s
Tests✗ · 699sran, no count parsed
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo1013 files~191,766 lines of source · 29.8 MB · 3 CI workflows · tests dir

Answers from our run

Does feynman build from source?

Dependencies installed in 76 seconds (985 packages), and the build succeeded in 27 seconds. We cloned commit dfdcb7c into a clean Debian container with 3 CPUs and no project-specific setup.

Do feynman's tests pass?

The test command failed in our container, and its output did not report a pass or fail count.

Does feynman have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use feynman?

Anyone seeking a narrow paper finder: the README spans web research, code audits, document parsing, notebooks, compute, biology sources, and artifact viewers.

What are the alternatives to feynman?

GPT Researcher, PaperQA, STORM. Our Feynman run installed 985 packages and used 1,329 MB, then its tests failed after 699 seconds, so this is a serious research workspace rather than a lightweight paper-search utility.

Setup3/576-second install, large footprint, and a failed test run
Docs5/5Install, providers, workflows, skills, and updates are documented
Community4/58,917 stars with fresh pushes and issue activity
Maturity3/5Frequent releases, but one warned release and a failing suite

Who it’s for

Researchers who want paper search, source comparison, citation checks, and drafting in one terminal workflow.
Scientific and machine-learning teams willing to inspect the agent's sources and keep human judgment in the loop.
Developers who want a local workbench plus a choice of hosted or local model providers.
Codex and Claude Code users who want to install only the bundled research skills instead of the full app.

Who it’s NOT for

Anyone seeking a narrow paper finder: the README spans web research, code audits, document parsing, notebooks, compute, biology sources, and artifact viewers.
Teams that cannot provide a hosted-model login or run a compatible local endpoint: setup expects one of those routes before the agent can research.
Administrators expecting one updater to replace the entire app: the README says feynman update refreshes Pi packages but does not update the standalone bundle.
Organizations unwilling to pin and review releases: v0.3.46 carries an explicit do-not-install warning about a shutdown failure, credentials in process arguments, and stale metadata.
Users bothered by visible integration churn: open issue 273 reports a startup warning when Feynman's /thinking command meets the same command in Pi 0.85.1.

Setup reality

Our Node 22 sandbox installed 985 packages in 76 seconds and used 1,329 MB. The build succeeded in 27 seconds. Tests failed with exit code 1 after 699 seconds; the log ended on an assertion that received error where it expected complete.

A useful session still needs a model route. Hosted providers require login or an API key, while local use expects LM Studio, LiteLLM, Ollama, or vLLM at a compatible endpoint. Paper and dataset sources may need their own credentials.

The native installer carries a pinned Node.js runtime and checks its SHA-256. The npm path uses the machine's Node runtime, and the source manifest requires Node 22.22.0 through 25. feynman update does not replace the standalone bundle.

Four research agents cover papers, code, and verification

Feynman v0.3.48 bundles four named agent roles: Researcher, Reviewer, Writer, and Verifier. The terminal can search papers and the web, rank literature, compare sources, audit a paper against its public code, prepare a replication plan, and draft from collected evidence. A separate serve command opens a local science workbench for projects, chat, artifacts, notebooks, compute, and provenance. This is much closer to a research cockpit than a chatbot with a paper-search prompt.

The choice of interface is unusually flexible. A native installer brings its own pinned Node.js runtime and verifies a SHA-256 before replacing an installation. The npm package uses the local runtime instead. People who only want the prompts and skills can install those into Codex, a repository agent folder, or OpenCode without taking the terminal, authentication store, and bundled runtime. That split gives teams a sensible way to test the research method before adopting the full application.

Sixteen named workflows make scope the main buying decision

The 29.8 MB checkout documents 16 commands and slash workflows, including rank, paper, lit, audit, replicate, recipe, and watch. PaperRank can expand citation graphs, fetch full text for selected papers, add critique, and record the model used for synthesis. The paper resolver accepts DOI, arXiv, OpenAlex, PMID, PMCID, or a title. Those are concrete research jobs, and they reduce the glue code otherwise needed between search services, PDFs, citation graphs, and an agent session.

That breadth carries a tax. The workbench also handles spreadsheets, media, LaTeX, chemistry files, biological sequences, structures, trees, and tensors. Its science connector catalog reaches literature indexes, clinical trials, drug records, molecular databases, genomics services, cancer resources, and omics archives. A lab using several of those sources may appreciate one stateful interface. A software team that only wants cited web research will spend time understanding features it never needs.

What happened when we ran it

Our sandbox cloned commit dfdcb7c, a 29.8 MB repository with 1,013 files and about 191,766 source lines. On 3 CPUs with 8 GB of RAM, npm installed 985 packages in 76 seconds and occupied 1,329 MB. The build succeeded in 27 seconds. The checkout had 3 CI workflow files and a tests directory, but no Dockerfile.

The test command ran for 699 seconds and exited with code 1. The final assertion shown in the log had an actual value of error and an expected value of complete; the tail did not identify a cause, so we will not supply one. A provider-retry subtest printed as passing immediately before the failing-tests summary. Npm audit reported 0 known vulnerabilities across critical, high, moderate, and low severities for the dependencies in our run.

Local models trade provider accounts for local services

Feynman documents 2 local endpoints: LM Studio on port 1234 and LiteLLM on port 4000. Ollama and vLLM can be connected as custom OpenAI-compatible providers. Hosted routes use feynman model login, an API key, or an OAuth flow depending on the provider. OpenRouter even documents a headless SSH path where the user pastes the final redirect URL or authorization code back into the prompt.

A local endpoint removes the need to send research prompts to a hosted model, but it does not make the whole workflow offline. Paper search, web retrieval, full-text access, code fetching, and specialist science sources still depend on network services. Some use public endpoints, while others accept tokens such as HF_TOKEN. Teams should map which sources receive a query, what gets cached, and which credentials are present before using confidential research questions.

Version v0.3.46 proves that release pinning matters

The release page tells users not to install v0.3.46 because it included a shutdown failure, exposed proxy or provider credentials in child-process arguments, and carried stale npm metadata. The next published version shown by GitHub is v0.3.48, dated September 6, 2026, which moved the canonical repository and npm package to the current owner and updated affected URL and query dependencies. That history shows maintainers documenting mistakes plainly, but it also makes blind auto-updates a bad policy.

GitHub showed 8,917 stars and 6 open issues and pull requests, with the last push on September 6, 2026. Issue 273 was opened the next day and already had a matching pull request to remove a duplicate /thinking command that causes a startup warning under Pi 0.85.1. The repository is active by both push date and issue work. It is also young, created in March 2026, and its quick succession of 0.3.x releases signals ongoing interface and packaging changes.

A 1,013-file agent needs a local acceptance set

Feynman is worth trying when research spans papers, the open web, public code, and specialist scientific records. Start with the skills-only install or one pinned native release, then run a few questions for which your team already knows the literature. Check citation destinations, claim support, source licensing, provider routing, and saved artifacts. The failed 699-second suite means our exact commit did not earn a clean bill of health, even though installation, build, and audit all completed successfully.

For a narrower problem, PaperQA or GPT Researcher will be easier to explain and contain. Feynman earns its larger 1,329 MB dependency footprint only when the workbench, research memory, artifact handling, and several workflow types are used together. Its strongest audience is a technical researcher who wants one configurable workspace and already treats model output as a draft that must survive source review.

Alternatives

ProjectWhat it isPick it when
GPT Researcher gh↗An agent focused on researching a question and assembling a sourced report.pick this instead when web report generation is the main job and Feynman's science workbench is unnecessary.
PaperQAA research assistant centered on answering questions from scientific literature with citations.pick this instead when evidence from papers matters more than a broad terminal agent and local workbench.
STORMA research system for building sourced, article-length reports through structured exploration.pick this instead when the desired output is a researched article rather than an ongoing science workspace.

What people are saying

  1. [github-trending] advaitpaliwal/feynman

Sources

  1. Feynman repository and README
  2. Feynman documentation
  3. Feynman installation guide
  4. Feynman v0.3.48 release
  5. Pi thinking command conflict issue

More ai tools reviews

personaplex · sepia · rf-detr · AIHawk · peft · DeepSpeed · the whole board →