What Miniconda is and why you might install it

Miniconda is a lightweight installer for Conda, a package manager that handles both Python libraries and non-Python tools. It gives you a minimal Python environment and the ability to create separate workspaces (called environments) for different projects, each with its own set of packages and Python versions. Unlike Anaconda, which comes pre-loaded with hundreds of packages you may never use, Miniconda starts small and lets you add only what you need.

You would install Miniconda if you work with Python regularly and want to avoid version conflicts between projects, manage scientific computing libraries like NumPy or Pandas, or keep your system Python separate from development work. It runs on Windows, macOS, and Linux.

Key Takeaways

  • Download the Miniconda installer from the official Conda website, choosing the version that matches your operating system and whether you have a 64-bit or 32-bit processor.
  • On Windows, run the installer executable and choose whether to add Miniconda to your system PATH during setup — most users should select this option.
  • On macOS and Linux, run a shell script from the terminal and accept the license agreement when prompted.
  • After installation, open a new terminal or command prompt and type conda --version to confirm Miniconda is working.
  • Create your first environment with conda create --name myproject python=3.11 and activate it with conda activate myproject.

Downloading the right installer for your system

Visit the official Conda website at conda.io/projects/conda/en/latest/user-guide/install/index.html and scroll to the Miniconda section. You will see installers for Windows, macOS, and Linux. Choose based on your operating system and processor type — most modern computers are 64-bit, but if you are unsure, check your system settings.

For Windows, download the .exe file. For macOS, choose between the Intel or Apple Silicon version depending on whether you have an older Intel Mac or a newer M1/M2/M3 Mac. For Linux, download the .sh file. The file size is typically 50 to 100 MB.

Installing on Windows

Open the downloaded .exe file by double-clicking it. A setup wizard will appear. Click through the welcome screen and read the license agreement, then click "I Agree" to continue.

On the "Select Installation Type" screen, choose "Just Me" unless you are setting up Miniconda for all users on the computer. Click "Next". On the next screen, you can change the installation folder — the default location (usually C:\Users\YourUsername\miniconda3) works fine for most people. Click "Next" again.

The "Advanced Installation Options" screen shows two checkboxes. The first, "Add Miniconda3 to my PATH environment variable", should be checked. This lets you run Conda commands from any command prompt without typing the full path. The second checkbox, "Register Miniconda3 as my default Python", is optional — check it only if you want Miniconda to be your system Python. Click "Install" and wait for the process to finish, then click "Finish".

Installing on macOS

Open the Terminal application (find it in Applications > Utilities or search for "Terminal" in Spotlight). Navigate to your Downloads folder by typing cd Downloads and pressing Enter. Then run the installer script by typing bash Miniconda3-latest-MacOSX-x86_64.sh if you have an Intel Mac, or bash Miniconda3-latest-MacOSX-arm64.sh if you have an Apple Silicon Mac. Replace the filename if you downloaded a different version.

Press Enter and read through the license agreement. When prompted, type "yes" to accept it. The installer will ask where to install Miniconda — press Enter to accept the default location. When asked whether to initialize Miniconda, type "yes". Close and reopen Terminal for the changes to take effect.

Installing on Linux

Open a terminal and navigate to your Downloads folder with cd Downloads. Run the installer by typing bash Miniconda3-latest-Linux-x86_64.sh (or the appropriate filename for your system). Press Enter and read the license agreement, then type "yes" when prompted to accept it.

The installer will ask for a location — press Enter to use the default. When asked whether to initialize Miniconda, type "yes". Close and reopen the terminal window for the changes to take effect.

Verifying the installation and creating your first environment

Open a new command prompt (Windows) or terminal (macOS and Linux). Type conda --version and press Enter. You should see output like "conda 23.11.0" or similar. If you see an error instead, close and reopen your terminal — sometimes the system needs a moment to recognize the new installation.

To create your first environment, type conda create --name myproject python=3.11 and press Enter. Replace "myproject" with whatever you want to call this workspace. Conda will download Python 3.11 and a few essential packages. When it asks "Proceed ([y]/n)?", type "y" and press Enter. To use this environment, type conda activate myproject. Your command prompt or terminal should now show "(myproject)" at the beginning of the line, indicating the environment is active.

Uninstalling Miniconda if you change your mind

On Windows, open Control Panel, go to "Programs and Features", find "Miniconda3", click it, and select "Uninstall". Follow the prompts to remove it completely.

On macOS and Linux, open a terminal and type rm -rf ~/miniconda3. This removes the Miniconda folder. You may also want to remove Conda initialization from your shell configuration by opening the file ~/.bashrc or ~/.zshrc (depending on your shell) in a text editor and deleting the lines that mention Conda — they usually appear at the end of the file and are marked with a comment like "# >>> conda initialize >>>". Save the file and close the terminal.

Frequently Asked Questions

What is the difference between Miniconda and Anaconda?

Anaconda includes Miniconda plus about 250 pre-installed packages like Jupyter, NumPy, and Pandas. Miniconda starts with just Python and Conda, so you install packages as you need them. Both use the same package manager. Choose Miniconda if you want a smaller download and faster setup, or Anaconda if you want common data science tools ready to go.

Do I need to uninstall Python before installing Miniconda?

No. Miniconda installs into its own folder and does not interfere with system Python. You can have both. If you added Miniconda to your PATH during installation, Conda commands will use Miniconda's Python by default, but your system Python remains unchanged.

Why does the terminal say "conda: command not found" after I installed it?

The terminal has not reloaded the new PATH settings yet. Close the terminal completely and open a new one. If the error persists on macOS or Linux, you may have declined to initialize Miniconda during installation — run ~/miniconda3/bin/conda init to set it up manually.

Can I have multiple environments with different Python versions?

Yes. Create a new environment with conda create --name project2 python=3.9 to make one with Python 3.9, or conda create --name project3 python=3.12 for Python 3.12. Switch between them with conda activate project2 or conda activate project3. Each environment is completely separate.

How do I install packages into an environment?

First activate the environment with conda activate myproject. Then type conda install numpy pandas to install NumPy and Pandas, or replace those names with whatever packages you need. Conda will resolve dependencies and ask for confirmation before installing.