Quickstart

This example shows the shortest meaningful path through design-research-experiments.

1. Install

pip install design-research-experiments

Or install from source:

git clone https://github.com/cmudrc/design-research-experiments.git
cd design-research-experiments
python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
pip install -e .

2. Minimal Runnable Example

from design_research_experiments import build_design, build_prompt_framing_study, validate_study

study = build_prompt_framing_study()
errors = validate_study(study)
if errors:
    raise RuntimeError("\n".join(errors))

conditions = build_design(study)
print(study.study_id)
print(f"conditions: {len(conditions)}")

3. What Happened

You defined a full study object, validated methodological consistency, and materialized admissible experimental conditions. This is the orchestration starting point before binding concrete runs.

4. Where To Go Next

• Concepts

• Typical Workflow

• Study Structure Example

• Examples Guide

Ecosystem Note

In a typical study, design-research-agents provides executable participants, design-research-problems supplies the task, design-research-experiments defines the study structure, and design-research-analysis interprets the resulting records.