# setting up a development environment

> Set up a development environment for writing and testing code.

- Skill: `majiayu000/setting-up-a-development-environment` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/setting-up-a-development-environment`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/setting-up-a-development-environment/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/setting-up-a-development-environment

---


# Setting Up a Development Environment

Use a reproducible, project-local environment and install NiMARE in editable mode so code changes are immediately available when running tests or examples.

## Creating or reusing an environment

- Prefer a local virtual environment (e.g., `.venv`) in the repository root; reuse it if it already exists.
- Use a supported Python version (`>=3.10`) consistent with `docs/installation.rst`.
- If no `.venv` exists, create and activate one:

  ```bash
  python3 -m venv .venv
  source .venv/bin/activate
  ```

- When installing dependencies, try `uv pip install ...` first to keep installs fast and deterministic.
- If `uv` is unavailable or fails, fall back to `.venv/bin/python -m pip install ...`.

## Installing NiMARE for development

- Install NiMARE in editable mode with all extras so tests and docs can run:

  ```bash
  uv pip install -e .[all]
  ```

- If that fails or `uv` is not installed, use:

  ```bash
  .venv/bin/python -m pip install -e .[all]
  ```

- Confirm the environment by importing NiMARE and running a small command, for example:

  ```bash
  python -c "import nimare; print(nimare.__version__)"
  ```