| name | setup |
| description | Set up and verify the nanogen development environment. Use when onboarding a new developer, after cloning the repo, when `uv sync` fails, when dependencies are broken, or when the user asks to install/fix/reset the environment. Triggers on "setup nanogen", "install dependencies", "uv sync failing", "fix environment", "fresh install", "verify setup". |
nanogen Setup
Prerequisites
- Python >=3.10, <3.14
- SSH access to G-REPA GitHub org — private deps are fetched via SSH
- uv —
curl -LsSf https://astral.sh/uv/install.sh | sh
Setup Steps
uv sync
uv run python skills/setup/scripts/verify_setup.py
Architecture
- pyproject.toml — single source of truth for all deps
- uv.lock — committed lockfile, resolves for Linux only
- PyTorch — pinned to
2.10.0+cu128, sourced exclusively from https://download.pytorch.org/whl/cu128
- Private deps —
dpg-evaluator, geneval-evaluator, t2v-metrics from G-REPA org via SSH, branch nanogen/package
Troubleshooting
See references/troubleshooting.md for fixes to common issues:
- 403/permission denied during git clone
- torch version resolution failures
- hardlink warnings
- nuclear reset (
rm -rf .venv uv.lock && uv sync)
Verification
Run uv run python skills/setup/scripts/verify_setup.py to check Python version, uv, SSH access, torch+CUDA, and private package imports.
