# Uv Python Env > Manage uv-based Python environments in a workspace. Use when Python or packages are missing, when a uv venv is absent, or when you need to initialize or sync dependencies with uv and run Python via uv. Use when this capability is needed. - Skill: `tomevault-io/uv-python-env` (Agent Skill, multi-file: 2 files) - Install (CLI): `npx skillmds@latest add tomevault-io/uv-python-env` - Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/uv-python-env/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: Coding & Dev Tools - Author: tomevault-io (https://skillmd.com/u/tomevault-io) - Updated: 2026-09-17 - Page: https://skillmd.com/skills/tomevault-io/uv-python-env --- # UV Python Environment ## Core workflow - Work from the workspace root. - If no `pyproject.toml` exists, initialize the project with `uv init .`. - If `pyproject.toml` exists and dependencies are defined, create or repair the env with `uv sync --no-cache --upgrade`. - Use `uv add ` for runtime dependencies and `uv add --dev ` for dev tools (e.g., `ipython`, `rich`, `see`). ## Activate and run - Activate the venv with `source /path/to/workspace/.venv/bin/activate`. - Prefer `uv run python ` to run scripts. - If a Python snippet is needed, write it to a `.py` file first and then run it. Avoid `uv run python -c ""`. - When writing a helper script, avoid `argparse` CLI scaffolding. Prefer small, local, low-coupling functions that take arguments, and call them explicitly under `if __name__ == "__main__":` without a `main()` function when possible. ## Troubleshooting - If Python is not found, activate the venv or run with `uv run`. - If a package is missing, add it with `uv add` (or `uv add --dev` for dev-only tools), then retry. --- > Converted and distributed by [TomeVault](https://tomevault.io/claim/singularitti) — claim your Tome and manage your conversions.