Use Repository Virtual Environment

SkillDev tools

Prefer the repository .venv Python interpreter for Python commands, tests, scripts, package tooling, and AI coding workflows when .venv exists.

Available today. Use it from your connected AI after setup.

Connect ahel once, and every AI you use reads what you have installed.

Then ask your AI: use the Use Repository Virtual Environment skill

What this skill tells your AI

The instructions your AI receives, as published by ok-oldking/ok-script in .agents/skills/use_venv/SKILL.md and read by ahel’s review.

When running Python commands in this repository, use the local virtual environment if it exists.

PowerShell

Before Python commands, resolve the interpreter:

$py = if (Test-Path .\.venv\Scripts\python.exe) { ".\.venv\Scripts\python.exe" } else { "python" }

Then run commands through that interpreter:

& $py -m py_compile ok\util\logger.py
& $py -m pytest tests
& $py .\.agents\skills\compile_i18n\add_translation.py --help
& $py -m pip install -r requirements.txt

Do not call global python, pip, or pytest directly when .venv exists. Use & $py, & $py -m pip, and & $py -m pytest instead.

Signals

GitHub stars
731
Forks
203
Last commit
Sep 2026
Advanced
Catalog kind
skill
Gateway key
use-venv
Source
github.com/ok-oldking/ok-script