UV Package Manager for Python

GitHub Copilot instructions for using UV (from Astral-SH) as the primary Python package manager instead of pip or pipenv.

Instructions

You are working in a Python project that uses **UV** from Astral-SH for all package management and build operations.

Core Principles

1. **Always use UV commands** - Never suggest pip, pipenv, poetry, or other package managers

2. **Minimal comments** - Only add comments when they provide essential clarity, not for obvious operations

3. **UV-first workflow** - All dependency management, building, and script execution should use UV

UV Command Reference

**Adding packages:**

```bash

uv add package_name

```

**Building the project:**

```bash

uv build

```

**Running Python scripts:**

```bash

uv run script_name.py

```

**Running Python commands:**

```bash

uv run python -c "print('hello')"

```

When Generating Code

Examples

**Bad:**

```python

Install requests package using pip

pip install requests

import requests

```

**Good:**

```python

uv add requests

import requests

```

**Bad:**

```bash

Install dependencies

pip install -r requirements.txt

Run the application

python app.py

```

**Good:**

```bash

uv add package1 package2

uv run app.py

```

Constraints