# Virtual Environment Configuration

> Use when you have a Python application (e.g., ROIAL-NMR) with documented dependencies and version constraints, and you need to install it on a fresh machine or verify that the environment can be reconstructed without import or runtime errors.

- Skill: `holobiomicslab/virtual-environment-configuration` (Agent Skill)
- Install (CLI): `npx skillmds@latest add holobiomicslab/virtual-environment-configuration`
- Raw SKILL.md: https://api.skillmd.com/api/skills/holobiomicslab/virtual-environment-configuration/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- License: CC-BY-4.0
- Author: HolobiomicsLab (https://skillmd.com/u/holobiomicslab)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/holobiomicslab/virtual-environment-configuration

---


# virtual-environment-configuration

## Summary

Configure a reproducible Python virtual environment with pinned dependencies to enable reliable execution of a scientific application. This skill ensures that exact package versions are installed in isolation, preventing dependency conflicts and enabling consistent behavior across machines.

## When to use

You have a Python application (e.g., ROIAL-NMR) with documented dependencies and version constraints, and you need to install it on a fresh machine or verify that the environment can be reconstructed without import or runtime errors. Use this skill when the application specifies a minimum Python version and explicitly pins package versions.

## When NOT to use

- Dependencies are already installed in the system Python or an existing virtual environment — use environment introspection or validation instead.
- The application does not provide version pinning or the documentation is incomplete — consider dependency inference tools or container-based solutions first.
- You need to modify or develop the application itself — this skill is for environment setup, not source code modification or debugging.

## Inputs

- GitHub repository URL
- Python version constraint (e.g., >=3.9)
- Pinned dependency list with exact versions

## Outputs

- Activated virtual environment with installed dependencies
- Confirmation that application entrypoint is invokable
- Running application instance or successful initialization without errors

## How to apply

Clone the source repository, then create a Python virtual environment specifying the minimum required version (Python ≥3.9 for ROIAL-NMR). Install each pinned dependency using pip with exact version specifiers (e.g., `pip install XlsxWriter==3.2.2 pandas==2.2.3 PyQt5==5.15.11 openpyxl==3.1.5`). After installation, invoke the documented entrypoint command (e.g., `python main.py`) to verify that all imports resolve and the application initializes without errors. Success is confirmed when the application launches without import errors, runtime exceptions, or missing dependency warnings.

## Related tools

- **Python** (Runtime interpreter; minimum version 3.9 required to execute ROIAL-NMR and its dependencies.) — https://www.anaconda.com/download/
- **pip** (Package installer used to install exact versions of XlsxWriter, pandas, PyQt5, and openpyxl into the virtual environment.)
- **venv** (Python standard library module for creating isolated virtual environments to prevent system-wide package conflicts.)
- **XlsxWriter** (Dependency version 3.2.2; used by ROIAL-NMR for Excel output file generation.)
- **pandas** (Dependency version 2.2.3; used for data manipulation and tabular data handling in ROIAL-NMR.)
- **PyQt5** (Dependency version 5.15.11; provides the graphical user interface (GUI) framework for ROIAL-NMR.)
- **openpyxl** (Dependency version 3.1.5; used for reading and writing Excel spreadsheet files.)

## Examples

```
python -m venv roial-env && source roial-env/bin/activate && pip install XlsxWriter==3.2.2 pandas==2.2.3 PyQt5==5.15.11 openpyxl==3.1.5 && python main.py
```

## Evaluation signals

- Virtual environment created successfully with Python version ≥3.9 confirmed via `python --version`.
- All five pinned dependencies installed without version conflicts: `pip list` shows XlsxWriter 3.2.2, pandas 2.2.3, PyQt5 5.15.11, openpyxl 3.1.5, plus transitive dependencies.
- Entrypoint `python main.py` executes without ImportError, ModuleNotFoundError, or missing dependency warnings.
- Application initializes and reaches a ready state (GUI appears, no traceback, or application reports successful startup).
- No runtime errors occur during the first interaction (e.g., opening a GUI dialog, loading a dataset) that would indicate incomplete or incompatible dependencies.

## Limitations

- This skill does not address runtime errors that arise from input data, configuration files, or application logic — only environment correctness.
- Platform-specific issues (e.g., PyQt5 GUI rendering on headless systems, system library dependencies) may prevent application execution even with correct Python packages.
- No changelog or version history was provided, so pinned versions may become outdated or incompatible with new operating systems or Python minor versions.
- The skill assumes the application's main.py entrypoint is the correct verification target; some applications may require additional setup steps not documented in the README.

## Evidence

- [other] ROIAL-NMR requires Python >=3.9 and five pinned dependencies (XlsxWriter 3.2.2, pandas 2.2.3, PyQt5 5.15.11, openpyxl 3.1.5): "ROIAL-NMR requires Python >=3.9 and five pinned dependencies (XlsxWriter 3.2.2, pandas 2.2.3, PyQt5 5.15.11, openpyxl 3.1.5)"
- [other] Create a Python virtual environment with Python ≥3.9. 3. Install dependencies using pip with exact versions: XlsxWriter 3.2.2, pandas 2.2.3, PyQt5 5.15.11, and openpyxl 3.1.5. 4. Execute `python main.py` to confirm the entrypoint is invokable and the application initializes without import or runtime errors.: "Create a Python virtual environment with Python ≥3.9. 3. Install dependencies using pip with exact versions: XlsxWriter 3.2.2, pandas 2.2.3, PyQt5 5.15.11, and openpyxl 3.1.5. 4. Execute `python"
- [readme] Python>=3.9: "[Python](https://www.anaconda.com/download/)>=3.9"