ChatUV 0.1.1

ChatUV: bootstrap uv-based Python environments from low-version Python shells

ChatUV

ChatUV bootstraps uv-based Python environments from low-version Python shells. It is a small standalone helper for the first step: install or find uv, install a requested Python runtime through uv, create a seeded virtual environment, and optionally make future shells auto-activate that environment.

Quick Start

pip install ChatUV
chatuv setup
chatuv --version

By default, chatuv setup creates ~/.chatarch/venv with Python 3.12 and pip:

chatuv setup --venv ~/.chatarch/venv --python 3.12

Useful options:

chatuv setup --force                 # recreate an existing target venv
chatuv setup --uv-path /path/to/uv    # use a specific uv binary
chatuv setup --dry-run                # print planned commands only
chatuv setup --no-activate            # do not edit shell rc files

When shell activation is enabled, ChatUV appends or updates a marked source block in existing ~/.zshrc and ~/.bashrc files. It does not create those files when they are missing.

Compatibility

ChatUV targets Python 3.6 and newer so it can be installed from older Python shells before bootstrapping newer uv-managed environments. The implementation avoids dependencies beyond the Python standard library.