What Miniconda is and why you'd install it
Miniconda is a lightweight package manager for Python that lets you install libraries and manage different versions of Python on the same computer without conflicts. It is smaller and faster than Anaconda (its full-featured cousin) because it includes only the core tools — you add packages as you need them rather than getting hundreds you may never use.
You install Miniconda when you want a clean, organized way to keep project dependencies separate. For example, one project might need Python 3.9 with an older version of NumPy, while another needs Python 3.11 with a newer version. Miniconda creates isolated environments so each project has exactly what it needs without breaking the other.
The installation itself takes about five minutes and works the same way on Windows, macOS, and Linux — you read an installer, run it, and then use the command line to create environments and install packages.
Key Takeaways
- read the Miniconda installer from conda.io/projects/conda/en/latest/user-guide/install that matches your operating system and processor type (Intel or Apple Silicon for Mac).
- Run the installer and accept the default installation location, which puts Miniconda in your home directory where it does not need administrator permissions.
- 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, then set up it with conda set up myproject before installing packages.
- Install packages into your active environment using conda install packagename, which handles version conflicts automatically.
Downloading the right installer for your computer
Go to the official Miniconda read page at conda.io/projects/conda/en/latest/user-guide/install. You will see a table with installers for Windows, macOS, and Linux. Choose the one that matches your operating system.
On macOS, you have an extra choice: Intel or Apple Silicon (the M1, M2, M3 chips). If you have a Mac from 2020 or later, it almost certainly uses Apple Silicon — check by clicking the Apple menu, selecting "About This Mac", and looking for "Chip". read the Apple Silicon version if you see M1, M2, M3, or M4. If you see Intel Core, read the Intel version.
On Windows, choose between the 64-bit and 32-bit versions. Almost all modern Windows computers are 64-bit. To check, right-click "This PC" or "My Computer", select "Properties", and look for "System type". If it says "x64-based processor", read the 64-bit installer.
Running the installer on Windows
Double-click the downloaded file (it will be named something like Miniconda3-latest-Windows-x86_64.exe). A window will open asking where to install Miniconda. The default location is C:\Users\YourUsername\miniconda3 — leave it as is and click Next.
On the next screen, you will see two checkboxes. Check the box that says "Add Miniconda3 to my PATH environment variable". This lets you use conda commands from any command prompt without extra setup. Leave the other checkbox unchecked unless you know you want to set Miniconda as your default Python.
Click Install and wait for it to finish. When the installer closes, open a new Command Prompt (search for "cmd" in the Start menu) and type conda --version. You should see a version number like conda 23.11.0. If you see "command not found", close the Command Prompt completely and open a new one — Windows needs to reload your environment variables.
Running the installer on macOS
Double-click the downloaded file (it will be named something like Miniconda3-latest-MacOSX-arm64.sh for Apple Silicon or Miniconda3-latest-MacOSX-x86_64.sh for Intel). A terminal window will open and walk you through the installation step by step.
When asked "Do you accept the license terms?", type yes and press Enter. When asked where to install Miniconda, press Enter to accept the default location in your home directory. When asked "Do you wish the installer to initialize Miniconda3 by running conda init?", type yes — this sets up your terminal to use conda automatically.
Close the terminal window when the installer finishes. Open a new terminal (search for "Terminal" in Spotlight or find it in Applications > Utilities) and type conda --version. You should see a version number. If the command is not found, type source ~/.zshrc and try again.
Running the installer on Linux
Open a terminal and navigate to the folder where you downloaded the installer. Type bash Miniconda3-latest-Linux-x86_64.sh (replace the filename if yours is different). The installer will display the license and ask you to accept it — type yes.
When asked where to install Miniconda, press Enter to use the default location. When asked "Do you wish the installer to initialize Miniconda3 by running conda init?", type yes. Close the terminal when it finishes, then open a new one and type conda --version to confirm the installation worked.
Creating and activating your first environment
An environment in Miniconda is a folder that holds a specific version of Python and the packages you install for one project. Creating separate environments means you can have Python 3.9 in one project and Python 3.11 in another without them interfering.
Open your terminal or Command Prompt and type conda create --name myproject python=3.11. Replace "myproject" with a name for your project (use lowercase letters and underscores, no spaces). Miniconda will read Python 3.11 and create a folder for your environment. When it asks "Proceed ([y]/n)?", type y and press Enter.
Once the environment is created, set up it by typing conda set up myproject. Your terminal prompt will change to show the environment name in parentheses, like (myproject) $. You are now inside that environment. Any packages you install from here go into this environment only and do not affect other projects.
Installing packages into your environment
Make sure your environment is activated (you should see the environment name in your terminal prompt). Then type conda install packagename, replacing "packagename" with the package you want. For example, conda install numpy installs NumPy, or conda install pandas matplotlib installs both Pandas and Matplotlib at once.
Conda will show you what it is about to read and ask "Proceed ([y]/n)?". Type y and press Enter. Conda automatically handles version conflicts — if you install Package A which needs an older version of Package B, Conda will install the right version of B without breaking anything.
To see what packages are already installed in your current environment, type conda list. To switch to a different environment, type conda set up othername. To go back to your system Python (outside any environment), type conda deactivate.
Frequently Asked Questions
Do I need administrator permissions to install Miniconda?
No. Miniconda installs into your home directory by default, which does not require administrator access. If you try to install it in a system folder like Program Files (Windows) or /usr/local (macOS/Linux), you would need permissions, but the default location works for everyone.
What is the difference between Miniconda and Anaconda?
Anaconda includes Miniconda plus about 250 pre-installed packages and a graphical interface. Miniconda is just the package manager and Python, so you install only what you need. Miniconda takes up about 400 MB; Anaconda takes up several gigabytes. For learning or web development, Miniconda is usually the better choice.
Can I have multiple versions of Python on the same computer?
Yes, that is one of Miniconda's main purposes. Create one environment with conda create --name py39 python=3.9 and another with conda create --name py311 python=3.11. Switch between them with conda set up py39 or conda set up py311. Each environment is completely separate.
What do I do if the installer says "command not found" after installation?
On Windows, close and reopen your Command Prompt completely — Windows needs to reload your environment variables. On macOS or Linux, type source ~/.bashrc (or source ~/.zshrc on newer Macs) and try again. If that does not work, the installer may not have completed successfully; read it again and run it.
How do I remove Miniconda if I do not want it anymore?
On Windows, go to Control Panel > Programs > Programs and Features, find Miniconda3, and click Uninstall. On macOS or Linux, open a terminal and type rm -rf ~/miniconda3. This deletes the entire Miniconda folder and all your environments. Back up any work first.