experiment-env-installer

Install reproducible Python environments for ML experiments with uv across compute backends.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/dongzhuoyao/deepresearch --skill experiment-env-installer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: experiment-env-installer
Source: https://github.com/dongzhuoyao/deepresearch/tree/main/.codex/skills/experiment-env-installer
Command: npx skills add https://github.com/dongzhuoyao/deepresearch --skill experiment-env-installer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the common, time-consuming pain points of setting up, reproducing, and maintaining Python environments for machine learning experiments across diverse compute backends, eliminating version conflicts, CUDA/ROCm driver mismatches, and inconsistent dependency setups that cause avoidable training failures and reproducibility issues.

Core Features & Use Cases

  • Cross-Backend uv-Based Setup: Enforces lockfile-driven dependency management using uv for reproducible installs across local workstations, cloud GPU instances, and HPC clusters, with explicit rules against Conda, pip, and Poetry to avoid environment drift.
  • Backend-Specific PyTorch Compatibility Guidance: Provides clear instructions for installing the correct PyTorch build for NVIDIA CUDA, AMD ROCm, legacy CUDA hosts, and CPU-only systems, including version compatibility checks and override examples for edge cases.
  • Pre-Flight Verification & Troubleshooting: Includes step-by-step pre-launch checks for GPU visibility, import validation, and environment fingerprinting, plus a comprehensive troubleshooting guide for common install failures, ABI mismatches, and stale environment issues.
  • Use Case Example: If you are migrating a training project from a local NVIDIA GPU workstation to an AMD ROCm-based HPC cluster, this Skill guides you through adjusting the PyTorch index URL, verifying driver compatibility, running smoke tests, and capturing an environment fingerprint to ensure the setup works before launching large-scale jobs.

Quick Start

Use the experiment-env-installer skill to configure a reproducible Python environment for your ML project on your current compute backend, verify GPU or ROCm compatibility, and complete all pre-flight checks before launching training runs.

Frequently Asked Questions about experiment-env-installer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I set up a reproducible PyTorch environment across different CUDA and ROCm backends?

To set up a reproducible PyTorch environment, use uv for lockfile-driven dependency management and apply backend-specific PyTorch index URLs for NVIDIA CUDA, AMD ROCm, or CPU-only systems. This enforces consistent installs across local workstations, cloud instances, and HPC clusters while avoiding environment drift.

How do I fix PyTorch CUDA or ROCm ABI mismatch errors during environment installation?

Fix PyTorch CUDA or ROCm ABI mismatch errors by validating driver compatibility, selecting the correct PyTorch build for your hardware, and using uv override examples for edge cases. Pre-launch verification checks GPU visibility and import validation to resolve common installation failures before training runs.

Does uv work for managing machine learning dependencies on HPC clusters?

Yes, uv works for managing machine learning dependencies on HPC clusters by enforcing lockfile-driven reproducible installs. It explicitly replaces Conda, pip, and Poetry to prevent environment drift across heterogeneous compute backends, capturing an environment fingerprint for long-term run reproducibility.

What is the best way to migrate a training project from an NVIDIA GPU to an AMD ROCm cluster?

The best way to migrate from NVIDIA to AMD ROCm is to adjust the PyTorch index URL, verify driver compatibility, and run smoke tests using pre-flight checks. Capturing an environment fingerprint ensures the setup works before launching large-scale jobs on the new compute backend.

Why should I use uv instead of Conda for reproducible machine learning experiments?

Use uv instead of Conda to achieve strict lockfile-driven reproducible installs for machine learning experiments. uv prevents the environment drift and inconsistent dependency setups common with Conda, ensuring version alignment and consistent states across diverse compute backends like HPC clusters and cloud instances.

How do I verify GPU visibility and environment consistency before launching large-scale training jobs?

Verify GPU visibility and environment consistency by running pre-launch checks for import validation and environment fingerprinting. This pre-flight verification confirms CUDA or ROCm driver compatibility and resolves stale environment issues, ensuring the setup works before launching large-scale training runs.