gitwtfhub

wtf is maieusis?

beibaidraco/maieusis — explained in plain English

Analysis updated 2026-05-18

16PythonAudience · researcherComplexity · 4/5LicenseSetup · hard

TL;DR

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

Why would anyone build with this?

REASON 1

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

REASON 2

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

REASON 3

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

REASON 4

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

What's in the stack?

PythonCodex CLIClaude CodeOpenAI APIAnthropic API

How it stacks up

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 spin it up?

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.

Wtf does this do

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.

Yoink these 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

wtf 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.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.