uv-global

Original source / Raw SKILL.md

---
name: uv-global
description: Provision and reuse a global uv environment for ad hoc Python scripts.
metadata: {"openclaw":{"always":true,"emoji":"🦞","homepage":"https://github.com/guoqiao/skills/blob/main/uv-global/uv-global/SKILL.md","os":["darwin","linux"],"tags":["python","uv","global","venv"],"requires":{"anyBins":["brew","uv"]}}}
---

# 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.



---

## Skill Companion Files

> Additional files collected from the skill directory layout.

### _meta.json

```json
{
  "owner": "guoqiao",
  "slug": "uv-global",
  "displayName": "UV Global",
  "latest": {
    "version": "0.1.2",
    "publishedAt": 1770770394288,
    "commit": "https://github.com/openclaw/skills/commit/5eb4c4f447d892627c46d7546506a9f65a591b9f"
  },
  "history": [
    {
      "version": "0.1.1",
      "publishedAt": 1770085381290,
      "commit": "https://github.com/clawdbot/skills/commit/7990617a8dcb0c62f3d6b2131965e5c6b4b86834"
    },
    {
      "version": "0.1.0",
      "publishedAt": 1769995123439,
      "commit": "https://github.com/clawdbot/skills/commit/6c5ec3970fa9c76aef7942983b3d7da17952d1eb"
    }
  ]
}

```