muv 0.1.6

Global environment management tool using uv
Documentation

muv

A command-line tool for managing global Python virtual environments using uv.

Features

  • Create and manage Python virtual environments
  • Install and uninstall packages
  • Activate and deactivate environments
  • List available environments
  • Run commands within environments

Installation

Option 1: Using Cargo

cargo install muv

Option 2: Download pre-built binaries

  1. Go to the Releases page
  2. Download the appropriate binary for your system:
    • muv-linux-amd64.tar.gz for Linux (x86_64)
    • muv-linux-arm64.tar.gz for Linux (ARM64)
    • muv-macos-amd64.tar.gz for macOS (Intel)
    • muv-macos-arm64.tar.gz for macOS (Apple Silicon)
  3. Extract the binary: 
    tar -xzf muv-*.tar.gz
  4. Move the binary to a directory in your PATH: 
    sudo mv muv /usr/local/bin/
# Or for a user-local installation:
# mkdir -p ~/.local/bin
# mv muv ~/.local/bin/
# export PATH="$HOME/.local/bin:$PATH"
  5. Make it executable: 
    chmod +x /usr/local/bin/muv
# Or for user-local:
# chmod +x ~/.local/bin/muv

Getting Started

After installation, you need to initialize muv in your shell:

# Initialize muv in your shell
muv init

# Source your shell configuration to apply changes
source ~/.bashrc  # or ~/.zshrc if using zsh

Usage

# Create a new environment

# Create a new environment
muv create myenv --p 3.10

# Activate an environment
muv activate myenv

# Install packages
muv install numpy pandas

# Run a command in an environment
muv run myenv python script.py

# Install from requirements.txt file
muv install -r requirements.txt

# Install from pyproject.toml file
muv install -t pyproject.toml

Add Auto Complete Support

users can generate completion scripts using:

Bash: muv completions bash > /usr/local/etc/bash_completion.d/muv

Zsh: muv completions zsh > "${fpath[1]}/_muv"

Fish: muv completions fish > ~/.config/fish/completions/muv.fish"

And then source or restart their shell.

Requirements

License

MIT