explaingit

beibaidraco/maieusis

Analysis updated 2026-05-18

16PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

TLDR

A Python tool that helps scientists form and test good research questions from a dataset and source papers before running any actual analysis.

Mindmap

mindmap
  root((repo))
    What it does
      Forms research questions
      Checks against dataset
      Produces dossier
    Tech stack
      Python
      Codex or Claude Code
      OpenAI and Anthropic APIs
    Use cases
      Question shortlisting
      Plan or reject checks
      Provenance trail
    Audience
      Researchers
      Scientists with datasets
    Requirements
      Python 3.11 to 3.13
      Separate API keys
      Read only dataset access

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

Turn a stack of source papers and a dataset into a shortlist of well-formed scientific questions.

USE CASE 2

Check whether a candidate research question can actually be answered with the data on hand before spending time analyzing it.

USE CASE 3

Get a readable, traceable record of why a question was accepted, rejected, deferred, or flagged.

USE CASE 4

Use a coding assistant like Claude Code or Codex CLI to manage sandboxed, read-only access to dataset files during question planning.

What is it built with?

PythonCodex CLIClaude CodeOpenAI APIAnthropic API

How does it compare?

beibaidraco/maieusis920linjerry-stack/capital-studioadya84/ha-world-cup-2026
Stars161616
LanguagePythonPythonPython
Setup difficultyhardeasyeasy
Complexity4/53/52/5
Audienceresearcherresearchergeneral

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

How do you get it running?

Difficulty · hard Time to first run · 1h+

Requires Python 3.11-3.13, a coding-agent host (Codex or Claude Code), and separate paid API keys for different scientific model providers.

Apache 2.0: use, modify, and distribute freely, including commercially, as long as you keep the copyright and license notices.

In plain English

Maieusis is a Python tool built around one idea: before scientists analyze data, they first have to figure out what question is even worth asking. Most AI research tools jump straight to running an analysis once a question is given to them. Maieusis works one step earlier, helping researchers form and test good questions before any analysis happens. Given a dataset, some source papers, and an optional research direction, Maieusis studies how those papers arrived at their scientific questions, then turns those patterns into new candidate questions for the current dataset. Each candidate question then goes through a check against the real dataset, where the tool asks whether the needed information is actually present, whether a fair comparison can be made, and whether the question can be answered without changing what it originally meant. The output is something the authors call a Scientific Question Dossier: a readable record showing either a workable plan for a question, or an explanation for why the question was rejected, deferred, or flagged with a warning. Every step leaves a paper trail so a researcher can see how each conclusion was reached. The project has three working parts. A coding assistant, either Codex CLI or Claude Code, handles a sandboxed workspace with limited, read-only access to dataset files. Separate AI models handle reading papers and generating candidate questions. A Python core enforces rules, checks outputs, tracks sources, and limits how many calls and retries can happen. The README is explicit that this is a research preview, version 0.1.0, and that it does not judge whether a question is novel, important, or true. It does not run the actual scientific analysis or claim any findings are correct. It requires Python 3.11, 3.12, or 3.13 and separate API keys for different AI providers, since it deliberately avoids using the same provider for question generation and independent review. It is released under the Apache 2.0 license.

Copy-paste prompts

Prompt 1
Help me set up Maieusis v0.1.0 in a clean project directory following its manual install steps.
Prompt 2
Walk me through configuring maieusis.yaml with my source papers and dataset without inventing any dataset facts.
Prompt 3
Explain what happens when I run maieusis check versus maieusis run, and why one costs money and the other doesn't.
Prompt 4
Show me how the Question Owner and Dataset Planner roles differ inside Maieusis.
Prompt 5
What does a Scientific Question Dossier look like and how do I read a reject or defer outcome?

Frequently asked questions

What is maieusis?

A Python tool that helps scientists form and test good research questions from a dataset and source papers before running any actual analysis.

What language is maieusis written in?

Mainly Python. The stack also includes Python, Codex CLI, Claude Code.

What license does maieusis use?

Apache 2.0: use, modify, and distribute freely, including commercially, as long as you keep the copyright and license notices.

How hard is maieusis to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is maieusis for?

Mainly researcher.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.