Installation

Requires Python 3.12+.

VS Code First

If you want a guided, editor-first path for creating a virtual environment, installing the published package, and running a first script, start with VS Code Setup Guide.

Package Install

Install the published package with a Python 3.12+ interpreter:

python3 -m pip install design-research-agents

Windows note: If python or pip resolve to an older interpreter, use py -3.12 -m pip install design-research-agents and py -3.12 -m venv .venv for virtual-environment setup.

Editable Install

git clone https://github.com/cmudrc/design-research-agents.git
cd design-research-agents
python3 -m venv .venv
source .venv/bin/activate
python -m pip install --upgrade pip
python -m pip install -e ".[dev]"

Maintainer Shortcut

make dev

Backend Extras

Backend clients are intentionally optional. Install only what your study needs. For example:

pip install -e ".[openai]"
pip install -e ".[anthropic]"
pip install -e ".[local]"
pip install -e ".[full]"
pip install -e ".[all]"

full covers hosted + local backends. all adds the optional ChromaDB and graph-memory extras on top of that backend bundle.

Use Dependencies and Extras for the complete matrix and platform caveats.