Use Repository Virtual Environment
SkillDev toolsPrefer 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.
No other account needed.
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