Metadata-Version: 2.4
Name: ChatUV
Version: 0.1.1
Summary: ChatUV: bootstrap uv-based Python environments from low-version Python shells
Author-email: ChatArch <1073853456@qq.com>
License: MIT
Keywords: chatuv
Classifier: Programming Language :: Python :: 3
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
Dynamic: license-file

# 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

```bash
pip install ChatUV
chatuv setup
chatuv --version
```

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

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

Useful options:

```bash
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.
