---
description: How to run Python scripts in this project
---

# Running Python Scripts

This project uses **`uv`** for Python script execution and dependency management.

## Important: Do NOT use `python` command

The `python` command is not available in the PATH. Instead, always use:

```bash
uv run script_name.py
```

## Why `uv`?

- All scripts use PEP 723 inline metadata (`# /// script`)
- `uv` automatically manages dependencies per script
- No need for virtual environments or requirements.txt
- Self-contained, isolated script execution

## Examples

```bash
# Run the multi-provider DOCX editor
uv run multi_provider_docx_editor.py input.docx --provider groq

# Run the Groq-only version
uv run groq_docx_editor.py input.docx

# Run any test script
uv run test_extraction.py
```

## Getting Help

```bash
uv run multi_provider_docx_editor.py --help
```