explaingit

shalinda-j/vibe-research

Analysis updated 2026-05-18

12PythonAudience · researcherComplexity · 3/5LicenseSetup · moderate

TLDR

A terminal tool that runs a team of AI agents to research any topic, fact-check claims, and produce a cited markdown report.

Mindmap

mindmap
  root((repo))
    What it does
      Multi agent research
      Fact checking
      Cited reports
    Tech stack
      Python
      Terminal UI
    Use cases
      Research reports
      Medical evidence review
      Local free mode
    Audience
      Researchers
      PMs and founders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Generate a fully cited research report on a topic by typing one command in the terminal.

USE CASE 2

Get a biomedical evidence review with clinical-grade fact-checking using the medical mode.

USE CASE 3

Run research fully offline and free using a local Ollama model instead of a paid API.

USE CASE 4

Build on earlier research automatically thanks to the tool's long-term memory across runs.

What is it built with?

Python

How does it compare?

shalinda-j/vibe-researchaim-uofa/reasonmatchairbone42/360-data-athlete
Stars121212
LanguagePythonPythonPython
Setup difficultymoderatehardhard
Complexity3/55/54/5
Audienceresearcherresearchergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Needs an API key for most backends, or a local Ollama install for the free option.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

In plain English

Vibe Research is a terminal tool that runs a small team of AI agents to research a topic and produce a cited report, without you having to manage each step yourself. You give it a topic, and a planner agent breaks it into sub-questions. Several researcher agents then work in parallel, each answering one sub-question using live web search. A panel of fact-checking agents reviews the claims that come back and votes on whether each one is well supported. An editor agent then decides whether the coverage is good enough, and if it is not, the whole crew re-plans and goes back to research the gaps before a final markdown report is written with citations. While it runs, a split-screen terminal interface shows the agents working on one side and the report building on the other, and the finished report is saved to disk automatically. The tool also keeps long-term memory across runs, so later research on a related topic can build on what a previous run already learned instead of starting from nothing. The README is upfront that the tool cannot guarantee zero mistakes, since any AI model can misread a source. To manage that, every claim is tied to a real source with a link, a separate verification pass rechecks claims, and every report ends with a section describing where the tool is unsure. For anything with real consequences, such as legal, financial, or health related questions, the README recommends reading that final section and checking the sources yourself. Vibe Research can connect to over a dozen different AI backends, including Anthropic's API, Anthropic's subscription based Agent SDK, OpenAI, Google Gemini, and several other providers, plus a fully local and free option through Ollama that needs no API key at all. It also supports specialized modes, such as a medical mode that reorganizes the whole research process around clinical evidence standards like trial types and safety data, and opens every report with a note that it is not medical advice. It installs with pipx, and additional features such as subscription mode or PDF export are available as optional extras. The project is written in Python and released under the MIT license.

Copy-paste prompts

Prompt 1
Run vibe-research on the topic: [your topic here] and save the cited report.
Prompt 2
Use vibe-research in medical mode to review the evidence on [a drug or treatment].
Prompt 3
Set up vibe-research with Ollama so I can research topics locally for free.
Prompt 4
Explain how vibe-research's fact-checking panel decides whether a claim is well supported.
Prompt 5
Show me how to switch vibe-research from API mode to my Claude subscription mode.

Frequently asked questions

What is vibe-research?

A terminal tool that runs a team of AI agents to research any topic, fact-check claims, and produce a cited markdown report.

What language is vibe-research written in?

Mainly Python. The stack also includes Python.

What license does vibe-research use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is vibe-research to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is vibe-research for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.