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
chatuv --tree
chatuv --tree-brief

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.

CLI Tree

On Python 3.10 and newer, ChatUV uses ChatStyle's registered Click tree runtime. The full tree includes the real setup signature:

chatuv
├── --help  # Show this message and exit.
├── --version  # Show the version and exit.
├── --tree  # Print the registered CLI tree and exit.
├── --tree-brief  # Print the registered CLI tree without parameter signatures and exit.
└── setup [--venv VENV] [--python PYTHON-VERSION] [--uv-path UV-PATH] [--force] [--no-activate] [--dry-run]  # Install uv and create a seeded venv; writes files unless --dry-run.

The brief tree keeps the same command surface without setup parameters:

chatuv
├── --help  # Show this message and exit.
├── --version  # Show the version and exit.
├── --tree  # Print the registered CLI tree and exit.
├── --tree-brief  # Print the registered CLI tree without parameter signatures and exit.
└── setup  # Install uv and create a seeded venv; writes files unless --dry-run.

Compatibility

ChatUV targets Python 3.6 and newer so it can be installed from older Python shells before bootstrapping newer uv-managed environments. Python 3.6-3.9 use a dependency-free standard-library fallback that provides --help, --version, and setup. Python 3.10 and newer install bounded Click and chatstyle>=0.2.0,<0.3.0 dependencies and additionally provide the shared --tree and --tree-brief contract.

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

chatuv-0.1.3.tar.gz (10.1 kB view details)

Uploaded Aug 21, 2026 Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

The dropdown lists show the available interpreters, ABIs, and platforms. Enable javascript to be able to filter the list of wheel files.

chatuv-0.1.3-py3-none-any.whl (8.4 kB view details)

Uploaded Aug 21, 2026 Python 3

File details

Details for the file chatuv-0.1.3.tar.gz.

File metadata

Download URL: chatuv-0.1.3.tar.gz
Upload date: Aug 21, 2026
Size: 10.1 kB
Tags: Source
Uploaded using Trusted Publishing? Yes
Uploaded via: twine/7.0.0 CPython/3.13.14

File hashes

Hashes for chatuv-0.1.3.tar.gz
Algorithm	Hash digest
SHA256	`98baccebe95ca09ba306913b3c83b9950d3b5480d8cf595bbd4f00a5d62addd2`
MD5	`b524db98680e778fa402660aa29d17d4`
BLAKE2b-256	`87325857a4ea36e9252c33800e2e9129a6bb3e423fba7e83241952d2f223157a`

See more details on using hashes here.

Provenance

The following attestation bundles were made for chatuv-0.1.3.tar.gz:

Publisher: publish.yml on ChatArch/ChatUV

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Statement:
- Statement type: https://in-toto.io/Statement/v1
- Predicate type: https://docs.pypi.org/attestations/publish/v1
- Subject name: chatuv-0.1.3.tar.gz
- Subject digest: 98baccebe95ca09ba306913b3c83b9950d3b5480d8cf595bbd4f00a5d62addd2
- Sigstore transparency entry: 2552515370
- Sigstore integration time: Aug 21, 2026
Source repository:
- Permalink: ChatArch/ChatUV@9bc88ee3d23b545b9e64240707254dc7732b8b5d
- Branch / Tag: refs/tags/v0.1.3
- Owner: https://github.com/ChatArch
- Access: public
Publication detail:
- Token Issuer: https://token.actions.githubusercontent.com
- Runner Environment: github-hosted
- Publication workflow: publish.yml@9bc88ee3d23b545b9e64240707254dc7732b8b5d
- Trigger Event: push