Metadata-Version: 2.3
Name: uvx
Version: 2.0.7
Classifier: Programming Language :: Rust
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Programming Language :: Python :: Implementation :: PyPy
Classifier: Operating System :: POSIX :: Linux
Classifier: Development Status :: 4 - Beta
Requires-Dist: uv
Requires-Dist: pip
Requires-Dist: patchelf
Requires-Python: >=3.10
Description-Content-Type: text/markdown; charset=UTF-8; variant=GFM

# uvx: pipx for uv

Inspired by:

- [pipx](https://github.com/pypa/pipx)
- [uv](https://github.com/astral-sh/uv)

## Installation

1. Install via pip (or alternatives):
    ```bash
    pip install uvx  # or `uv`, `pipx`
    ```

2. Optional (for bash users):
    - Ensure that `~/.local/bin` is in your PATH:
        ```bash
        uvx ensurepath
        ```
    - Enable tab completion for `uvx`:
        ```bash
        uvx completions --install
        ```

## Usage

```bash
uvx
```

Run `uvx` without any arguments to see all possible subcommands.

## Platform Considerations

- **Rust-Powered Performance (uvx 2.0):** Starting from version 2.0, `uvx` leverages Rust for improved performance and
  compatibility with `uv`.
- **Prebuilt Binaries:** Currently, prebuilt binaries are available for x86_64 (amd64) and aarch64 (ARM64) on Linux.
- **Other Platforms:** If you're on a different platform, you can still use `uvx 1.x`, which is written in pure Python.
  Find it at [robinvandernoord/uvx](https://github.com/robinvandernoord/uvx).
- Alternatively, you can **Compile for Your Platform**:
    - Install the Rust toolchain:
        ```bash
        curl https://sh.rustup.rs -sSf | sh
        ```
    - Clone the `uvx2` repo and navigate to it:
        ```bash
        git clone https://github.com/robinvandernoord/uvx2.git
        cd uvx2
        ```
    - Set up a virtual environment (choose Python or uv):
        ```bash
        python -m venv venv  # or `uv venv venv --seed`
        source venv/bin/activate
        ```
    - Install Maturin (Python with Rust package builder):
        ```bash
        pip install maturin  # or `uv pip install maturin`
        ```
    - Compile and install the `uvx` binary:
        ```bash
        maturin develop
        ```
    - Now you can use `uvx`:
        ```bash
        ./venv/bin/uvx
        ```

For additional details on building and distribution, refer to [maturin](https://www.maturin.rs/distribution)
documentation.

## License

`uvx` is distributed under the terms of the [MIT](https://spdx.org/licenses/MIT.html) license.

## Changelog

See `CHANGELOG.md` [on GitHub](https://github.com/robinvandernoord/uvx2/blob/master/CHANGELOG.md)

