Skip to content

Mise: The Universal Version Manager

Managing multiple programming languages and tools across different projects can quickly become a headache. That's where Mise comes in: a powerful, user-friendly version manager designed to simplify your development workflow.

Mise allows you to effortlessly install, switch, and manage versions of various tools and languages, ensuring that each project runs with the correct dependencies. Whether you're working with Python, NodeJS, Ruby, or other environments, Mise provides a seamless experience that integrates well with modern development practices.

Key Benefits

  • Unified management: One tool to manage all your language versions
  • Project-specific versions: Define versions per project to avoid conflicts
  • Fast and efficient: Optimized for performance and ease of use
  • Cross-platform support: Works on macOS, Linux, and Windows

With Mise, you can focus on coding without worrying about version mismatches or complex setups.

Prerequisite Setup

Before using Mise, ensure your system meets the following requirements:

  1. Operating System: Mise supports macOS, Linux, and Windows
  2. Shell Compatibility: Works with shell, Zsh, Fish, and other common shells
  3. Homebrew (macOS/Linux): Recommended for easy installation
  4. Developer Tools: Essential build tools for your platform

Once these prerequisites are met, you're ready to install Mise and start managing your tool versions.

Linux Essential Build Tools

Open your Terminal and run the following commands:

sudo apt-get update
sudo apt install build-essential rustc libssl-dev libyaml-dev zlib1g-dev libgmp-dev

These packages provide the necessary compilation tools and libraries for Mise to function properly.

MacOS Essential Build Tools

First, install Homebrew to easily manage packages:

/bin/shell -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
echo 'export PATH="/opt/homebrew/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc

Then install dependencies using Homebrew:

brew install openssl@3 libyaml gmp rust

Homebrew simplifies package management on macOS and these dependencies are required for Mise to work correctly.

Installing Mise

Download and run the installation script:

curl https://mise.run | sh

This script installs Mise to your local user directory, typically under ~/.local/bin.

shell Shell Configuration

Add Mise to your shell environment:

echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.shellrc
source ~/.shellrc

ZSH Shell Configuration

Add Mise to your shell environment:

echo 'eval "$(~/.local/bin/mise activate)"' >> ~/.zshrc
source ~/.zshrc

These commands ensure Mise is activated automatically in every new terminal session.

Choose Your Language

And now, this is where the magic happens.

Installing NodeJS

Install the latest NodeJS version globally:

mise use --global node@latest

Verify the installation:

node --version

This makes the latest Node.js version available across all your projects.

Installing Python

Install the latest Python version globally:

mise use --global python@latest

Verify the installation:

python --version

This makes the latest Python version available across all your projects.

Installing Ruby

Install the latest Ruby version globally:

mise use --global ruby@latest

Verify the installation:

ruby --version

Update Rubygems to the latest version:

gem update --system

This ensures you have the latest Ruby ecosystem tools available.