Metadata-Version: 2.4
Name: flex-uv
Version: 0.2.0
Summary: The Interactive UV Command Center — a Textual TUI for uv
Project-URL: Homepage, https://github.com/chirschauer/flex_uv
Project-URL: Repository, https://github.com/chirschauer/flex_uv
Project-URL: Issues, https://github.com/chirschauer/flex_uv/issues
Author: Chris Hirschauer
License: MIT License
        
        Copyright (c) 2026 Chris Hirschauer
        
        Permission is hereby granted, free of charge, to any person obtaining a copy
        of this software and associated documentation files (the "Software"), to deal
        in the Software without restriction, including without limitation the rights
        to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
        copies of the Software, and to permit persons to whom the Software is
        furnished to do so, subject to the following conditions:
        
        The above copyright notice and this permission notice shall be included in all
        copies or substantial portions of the Software.
        
        THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
        IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
        FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
        AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
        LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
        OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
        SOFTWARE.
License-File: LICENSE
Keywords: cli,package-manager,python,textual,tui,uv
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Topic :: Software Development :: Build Tools
Classifier: Topic :: Utilities
Requires-Python: >=3.10
Requires-Dist: textual>=0.80.0
Description-Content-Type: text/markdown

# ⚡ FlexUV

<p align="center">
  <img src="https://raw.githubusercontent.com/chirschauer/flex_uv/main/src/flex_uv/flexuv-icon.png" alt="FlexUV logo" width="200"/>
</p>


### The Interactive Command Center for `uv`

> Stop memorizing `uv` commands.
> Manage Python environments visually — **without leaving your terminal.**

FlexUV is a **terminal UI (TUI)** built with **Textual** that turns the `uv` Python ecosystem into a **visual command center**.

Instead of typing dozens of commands, you get a **guided interface for managing projects, environments, dependencies, and tools**.

Think:

> **LazyGit — but for Python environments.**

---

# 🚀 Demo

```
███████╗██╗     ███████╗██╗  ██╗██╗   ██╗██╗   ██╗
██╔════╝██║     ██╔════╝╚██╗██╔╝██║   ██║██║   ██║
█████╗  ██║     █████╗   ╚███╔╝ ██║   ██║██║   ██║
██╔══╝  ██║     ██╔══╝   ██╔██╗ ██║   ██║╚██╗ ██╔╝
██║     ███████╗███████╗██╔╝ ██╗╚██████╔╝ ╚████╔╝
╚═╝     ╚══════╝╚══════╝╚═╝  ╚═╝ ╚═════╝   ╚═══╝

FlexUV — The Interactive UV Command Center
```

---

# ✨ Features

### 🧭 Dashboard

See the state of your environment instantly.

* OS + Python detection
* `uv` installation check
* project detection
* environment markers

---

### 📦 Project Management

Run core `uv` workflows from a guided interface.

```
uv init
uv sync
uv lock
uv tree
```

Create new projects and configure:

* package name
* description
* Python version

---

### 📚 Dependency Management

Add or remove dependencies quickly.

```
uv add fastapi
uv remove requests
```

Run commands directly inside your project environment.

---

### 🐍 Python Version Manager

Manage Python versions with `uv`.

```
uv python install 3.12
uv python list
uv python find
uv python pin
```

---

### 🧰 Tool Manager

Install global developer tools.

```
uv tool install ruff
uv tool uninstall black
uv tool list
```

Run tools with `uv tool run`.

---

### 🔁 Pip Compatibility Mode

Still need pip workflows?

FlexUV exposes:

```
uv pip install
uv pip uninstall
uv pip list
uv pip freeze
uv pip tree
```

---

### ⚡ Command Center

Quick-access presets:

```
uv version
uv self update
uv cache dir
uv cache clean
uv tool list
uv python list
```

Or run **custom uv commands**.

---

### 📜 Command Logging

Every command executed is logged.

```
$ uv add textual

Installed successfully

(exit code: 0)
```

No hidden magic — you always see what happens.

---

# 🖥 Interface

FlexUV organizes everything into tabs:

```
Dashboard
Project
Python
Tools
Pip Mode
Command Center
Logs
```

It’s designed to feel like a **modern terminal application**.

---

# 📦 Installation

First install **uv**:

```
curl -LsSf https://astral.sh/uv/install.sh | sh
```

Then run FlexUV:

```
python app.py
```

---

# 🧠 Why FlexUV Exists

`uv` is incredibly powerful.

But command-heavy tools have a discoverability problem.

FlexUV solves this by providing:

* visual workflows
* command guidance
* environment awareness
* command logs
* safer actions

All **without leaving the terminal**.

---

# 🛠 Built With

* Python
* Textual
* Rich
* uv

---

# 🗺 Roadmap

Planned improvements:

* dependency graph visualization
* environment health checks
* plugin system
* task runner integration
* project templates
* package security scanning

---

# ⭐ Contributing

Contributions welcome!

If you have ideas, open an issue or PR.

---

# 🔥 If You Like This Project

Give it a ⭐ on GitHub.

It helps the project grow and reach more developers.

---

If you want, I can also give you **3 things that massively increase GitHub stars**:

1️⃣ **A README banner that looks like a dev tool homepage**
2️⃣ **A screenshot section that makes the project look polished**
3️⃣ **A Hacker News launch post that drives traffic to the repo**

Those three together can take a repo from **0 → 500 stars very quickly**.

