Skip to content

Commit 44ea172

Browse files
committed
minor changes
1 parent 87024f3 commit 44ea172

1 file changed

Lines changed: 42 additions & 19 deletions

File tree

  • docs/getting-started/development-tools

docs/getting-started/development-tools/conda.md

Lines changed: 42 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,24 +1,57 @@
11
# Conda Guide
2+
updated 11/23/2025 by JDY
23

3-
Conda is a powerful package and environment management system, particularly popular in data science and scientific computing. It can manage both Python packages and system-level dependencies.
4+
Conda is a tool that makes handling your Python (and other language) environments much easier, especially if you're new to programming or scientific computing. It helps you install packages and set up isolated environments—a bit like giving every project its own clean workspace. This means you don't have to worry about one project messing up the packages in another, and you can easily install tricky libraries used in data science.
45

56
---
67

7-
## What is Conda?
8+
## What is Conda, and Why should you use it?
89

9-
Conda is an open-source package management system and environment management system that runs on Windows, macOS, and Linux. It can:
10+
Conda is an open-source program for managing packages and environments on Windows, macOS, and Linux. For beginners, it's useful because it simplifies many common headaches in Python:
1011

11-
- Install packages and their dependencies
12-
- Create isolated environments
13-
- Manage multiple Python versions
14-
- Handle binary packages (not just Python)
15-
- Work with pip and other package managers
12+
- **Install packages and dependencies automatically**: You don’t have to track down and install everything by hand.
13+
- **Create isolated environments**: Each project gets its own space, so you can try things without breaking other projects.
14+
- **Switch between different Python versions easily**: If you need an older or newer Python for a specific project, it’s no problem.
15+
- **Install binary packages (not just Python)**: Many data science libraries rely on system-level tools—conda handles them for you.
16+
- **Works with pip and other package managers**: You can use your favorite tools together.
17+
18+
**In short:** Conda makes life easier for beginners by taking care of most of the tricky setup so you can focus on learning, coding, and running your projects.
1619

1720
---
1821

1922
## Installation
2023

21-
### Install Miniconda (Recommended)
24+
25+
26+
### Install Miniconda via Homebrew
27+
28+
You can also install Miniconda using Homebrew, which is often easier than downloading the installer manually:
29+
30+
```bash
31+
# Install Miniconda (Apple Silicon or Intel)
32+
brew install --cask miniconda
33+
34+
# After installation, add conda to your PATH:
35+
# This command sets up conda for your shell (zsh shown here)
36+
echo 'export PATH="/opt/homebrew/Caskroom/miniconda/base/bin:$PATH"' >> ~/.zshrc
37+
38+
# Initialize conda in your shell
39+
conda init zsh # or bash, fish, etc.
40+
41+
# Restart your terminal or source your shell rc file:
42+
source ~/.zshrc
43+
44+
```
45+
46+
> **Tip:** For more about `zsh` and your configuration file (`.zshrc`), see:
47+
> - [Oh My Zsh](https://ohmyz.sh/) (for managing your `zsh` shell)
48+
> - [What is .zshrc?](https://linuxize.com/post/zshrc-file/) (explains the `.zshrc` file)
49+
50+
> **Note:** On Intel Macs, your path may be `/usr/local/Caskroom/miniconda/base/bin` rather than `/opt/homebrew/Caskroom/miniconda/base/bin`.
51+
52+
For more details, see the [Homebrew Miniconda cask documentation](https://formulae.brew.sh/cask/miniconda).
53+
54+
### Install Miniconda via Manual Download
2255

2356
Miniconda is a minimal installer that includes conda, Python, and a few essential packages:
2457

@@ -40,16 +73,6 @@ bash Miniconda3-latest-MacOSX-arm64.sh # or x86_64.sh for Intel
4073
# - Type 'yes' to initialize conda
4174
```
4275

43-
### Install Anaconda (Full Distribution)
44-
45-
Anaconda includes conda plus 150+ pre-installed packages:
46-
47-
```bash
48-
# Download from: https://www.anaconda.com/products/distribution
49-
# Or use Homebrew:
50-
brew install --cask anaconda
51-
```
52-
5376
### Initialize Conda
5477

5578
After installation, restart your terminal or run:

0 commit comments

Comments
 (0)