# Uv Global

> Provision and reuse a global uv environment for ad hoc Python scripts.

- Skill: `modbender/uv-global` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add modbender/uv-global`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/uv-global/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/uv-global

---


# UV Global

Create and reuse a global `uv` environment at `~/.uv-global` so you can install Python dependencies for quick, ad hoc scripts without polluting the system interpreter.

Lightning-fast setup that keeps one shared virtual environment ready for temporary tasks.

Use this skill when the user needs Python packages (data processing, scraping, etc.) that are not preinstalled and a full project-specific environment would be overkill. Skip this if the user explicitly wants system Python or a project-local venv.

## Requirements

`uv` available. If missing, you need either `brew` (macOS/Linux) or `curl` to install it.

## Installation

```bash
bash ${baseDir}/install.sh
```

The script will:

- install `uv` via `brew` (macOS/Linux) or the official `curl` installer if `uv` is absent
- create a global uv project at `~/.uv-global`
- create a virtual environment with common packages in `~/.uv-global/.venv`
- create a few useful shims in `~/.uv-global/.venv/bin`

[Optional]prepend the venv bin to your `PATH` so `python` defaults to the global env and shims are available:

```
export PATH=~/.uv-global/.venv/bin:$PATH
```

## Usage

For any quick Python script that needs extra dependencies:

```bash
# install required packages into the global env
uv --project ~/.uv-global add <pkg0> <pkg1> ...

# write your code
touch script.py

# run your script using the global env
uv --project ~/.uv-global run script.py
```

Tips:
- Keep scripts anywhere; the `--project ~/.uv-global` flag ensures they run with the global env.
- Inspect installed packages with `uv --project ~/.uv-global pip list`.
- If a task grows into a real project, switch to a project-local venv instead of this global one.