whatisgithub

What is co-scientist?

kaimen-inc/co-scientist — explained in plain English

Analysis updated 2026-05-18

115PythonAudience · researcherComplexity · 3/5Setup · moderate

In one sentence

An open-source Python system where seven AI agents collaborate to turn a research question into ranked scientific hypotheses.

Mindmap

mindmap
  root((Co-Scientist))
    What it does
      Generates hypotheses
      Multi agent debate
      Elo ranking
    Tech stack
      Python
      SQLite queue
      Multiple AI providers
    Use cases
      Research ideation
      Literature grounded hypotheses
      Live progress dashboard
    Audience
      Researchers
      Scientists
    Agents
      Generation
      Reflection
      Ranking
      Meta review

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

Give the system a research question and get back a ranked list of candidate hypotheses.

USE CASE 2

Watch the agent debate and ranking process live through the optional web dashboard.

USE CASE 3

Plug in PubMed, arXiv, or web search API keys to ground hypotheses in existing literature.

What is it built with?

PythonSQLite

How does it compare?

kaimen-inc/co-scientistvinta/hal-9000nader0913/ocpp-rag
Stars115115114
LanguagePythonPythonPython
Setup difficultymoderatemoderatemoderate
Complexity3/53/5
Audienceresearcherdeveloperdeveloper

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

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires an API key from an AI provider like Anthropic, OpenAI, or Gemini, and a dollar budget for the run.

So what is it?

This is an open-source Python re-implementation of a research system described in a 2026 Nature paper by Google DeepMind called AI co-scientist. The original system uses multiple AI agents working together to take a research question written in plain language and produce a ranked list of novel scientific hypotheses. This repository follows the same agent structure and prompts described in the paper. The system has seven specialized agents, each with a distinct role. The Generation agent proposes new hypotheses by simulating a literature review and a scientific debate. The Reflection agent reviews each hypothesis for novelty and correctness. The Ranking agent runs an Elo tournament, the same scoring method used in chess, where hypotheses are compared against each other in simulated debates. The Evolution agent takes top-ranked hypotheses and tries to combine, simplify, or reframe them. The Proximity agent groups similar hypotheses together to reduce duplication and improve how the tournament pairs them up. The Meta-review agent synthesizes all feedback and writes the final research overview. A Supervisor coordinates all of these agents, manages a task queue backed by a local SQLite database, and writes the final output to a file. To run a session, you give it a research goal as a sentence, set a dollar budget and a time limit, and the system works through the agent cycle until it reaches one of its stopping conditions. The final output is a markdown file containing the research overview. There is also an optional web dashboard you can open in a browser that shows live progress. The tool works with many different AI providers including Anthropic, OpenAI, OpenRouter, Gemini, Groq, and others. You configure which provider to use and supply an API key. It also supports optional research tools like PubMed search, arXiv search, and web search if you provide the relevant API keys. The project is not affiliated with Google or the paper's authors. It is an independent implementation aimed at making the co-scientist approach available to researchers who want to run it themselves.

Copy-paste prompts

Prompt 1
Explain what each of the seven agents in this repo does, from Generation through Meta-review.
Prompt 2
Walk me through setting up an API key and running my first research session with this tool.
Prompt 3
How does the Ranking agent's Elo tournament in this repo decide which hypothesis is best?
Prompt 4
Using this repo, help me phrase a research goal sentence that would work well as input.

Frequently asked questions

What is co-scientist?

An open-source Python system where seven AI agents collaborate to turn a research question into ranked scientific hypotheses.

What language is co-scientist written in?

Mainly Python. The stack also includes Python, SQLite.

How hard is co-scientist to set up?

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

Who is co-scientist for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.