check-env

Check Environment

Verify that all required tools and dependencies are installed and correctly configured.

Steps

1. Check each required tool and report its version (or "not found"):

| Tool | Command | Minimum |

| ---- | ------- | ------- |

| Quarto | quarto --version | >= 1.4 |

| uv | uv --version | any |

| Python | python3 --version | >= 3.12 |

| R | R --version | optional |

| Stata | which stata | optional |

| TeX Live | pdflatex --version | optional (for PDF) |

| GitHub CLI | gh --version | optional |

1. Check Jupyter kernels by running uv run jupyter kernelspec list and verify:

• python3 — required
• ir — optional (needed for R notebooks)
• nbstata — optional (needed for Stata notebooks)

1. Check the Python virtual environment:

• Verify .venv/ exists
• Run uv run python -c "import numpy; import pandas; import matplotlib; import jupytext; print('Core packages OK')" to confirm importability

1. Check nbstata configuration (if nbstata kernel is present):

• Verify ~/.config/nbstata/nbstata.conf exists
• Read it and check that stata_dir points to an existing directory

1. Report a structured results table:

   Tool/Check              Status    Version/Details
   ─────────────────────────────────────────────────
   Quarto                  PASS      1.6.x
   uv                      PASS      0.x.x
   Python                  PASS      3.12.x
   R                       PASS      4.x.x
   Stata                   SKIP      not found (optional)
   TeX Live                PASS      2024
   GitHub CLI              PASS      2.x.x
   Kernel: python3         PASS      installed
   Kernel: ir              PASS      installed
   Kernel: nbstata         SKIP      not installed
   .venv/                  PASS      exists
   Core Python packages    PASS      importable
   nbstata.conf            SKIP      kernel not installed

Use PASS / FAIL / SKIP (SKIP for optional tools that are absent).

1. If any required check fails, provide the installation command or link to fix it.