Installation

design-research requires Python 3.12 or newer. Start with the published umbrella package when you want the complete package family and its shared namespace.

Install The Published Package

Create an isolated environment, then install from PyPI:

python -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install design-research

On Windows, activate the same environment with .venv\Scripts\activate. See Run An Example In VS Code for interpreter selection and platform-specific activation commands.

The base install resolves the exact Problems, Agents, Experiments, and Analysis versions recorded in Compatibility And Package Status. That matrix is the combination tested by this umbrella release; it is not a compatibility promise for unlisted component versions.

Component Packages And Extras

Install a component directly when you need only that package or one of its optional backends. Optional runtime dependencies are defined and documented by the package that uses them:

• Problems documentation

• Agents documentation and provider extras

• Experiments documentation

• Analysis documentation

Repository Development

For a source checkout, install the umbrella contributor toolchain:

git clone https://github.com/cmudrc/design-research.git
cd design-research
python -m venv .venv
source .venv/bin/activate
make dev

Maintainer workflows target Python 3.12 from .python-version. Continue to Quickstart for the installed-package smoke step and repository validation commands.