python-isolation.md

Python Isolation

Language: English · 中文

Use one uv virtual environment per skill.

Principles

1. One skill, one venv.
2. uv manages creation and installation.
3. A generated wrapper hides platform-specific library paths.
4. Rewrites are reversible.
5. Generated .venvs/ are local state and stay out of git.

Commands

venv-manager.sh create <skill-name> [pkg...]
venv-manager.sh install <skill-name> [pkg...]
venv-manager.sh doctor <skill-name>
venv-manager.sh rewire <skill-name>
venv-manager.sh remove <skill-name>
venv-manager.sh list

Environment Variables

Variable	Default	Purpose
VENV_ROOT	~/.config/opencode/.venvs	uv venv root
SKILL_ROOT	~/.agents/skills	shared skill root (every agent reads it)
UV_BIN	auto-detected	uv executable