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.