# How to Activate the Conda Environment for AI for Beginners

> Activate the Conda environment for AI for Beginners with a simple command. Follow this guide to get your AI development setup running quickly and easily.

- Repository: [Microsoft/AI-For-Beginners](https://github.com/microsoft/AI-For-Beginners)
- Tags: how-to-guide
- Published: 2026-08-22

---

**To activate the Conda environment for AI for Beginners, run `conda activate ai4beg` after initially creating it with `conda env create -f environment.yml` from the repository root.**

The microsoft/AI-For-Beginners repository provides a comprehensive curriculum for learning artificial intelligence through hands-on Jupyter notebooks. To ensure reproducibility across different systems, the project uses a dedicated Conda environment named `ai4beg` defined in the root [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) file. This guide walks you through the exact commands to activate the Conda environment for AI for Beginners and verify your setup.

## Prerequisites

Before activating the environment, ensure you have **Anaconda** or **Miniconda** installed on your system. The repository requires Conda to resolve complex dependencies including PyTorch, OpenCV, and specialized AI libraries pinned to specific versions.

## Creating the Environment

The first step is to build the isolated Python environment using the configuration file located at [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) in the repository root. This YAML file specifies all required packages including Python, Jupyter, NumPy, PyTorch, and OpenCV with specific version constraints.

Run the following command from the repository root directory:

```bash
conda env create -f environment.yml

```

Conda reads the YAML definition, resolves the dependency tree, and constructs an environment named **`ai4beg`**. This process may take several minutes as it downloads and installs the scientific computing stack.

## Activating the Environment

Once the environment is built, you must activate it to access the installed packages. Activating modifies your shell's PATH and environment variables to prioritize the `ai4beg` environment over your base Python installation.

Execute the activation command:

```bash
conda activate ai4beg

```

After successful activation, your shell prompt will display **`(ai4beg)`** before the directory path, indicating that the environment is active and ready for use.

## Verifying the Installation

Confirm that the key machine learning libraries are accessible by running a quick import test:

```bash
python -c "import torch, cv2, numpy; print('OK')"

```

If the command prints `OK` without errors, PyTorch, OpenCV, and NumPy are correctly installed within the active environment according to the specifications in [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml).

## Launching Jupyter

With the environment activated, you can now launch Jupyter Lab or Notebook to run the curriculum examples:

```bash
jupyter lab

```

Alternatively, use `jupyter notebook` if you prefer the classic interface. Both commands will start the server using the Python interpreter and packages from the `ai4beg` environment.

## Rebuilding the Environment

If you modify [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) or encounter dependency conflicts, completely remove and recreate the environment:

```bash
conda env remove -n ai4beg
conda env create -f environment.yml

```

This ensures a clean slate with the exact package versions specified in the current YAML file. For cloud-based alternatives, the repository also provides [`binder/environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/binder/environment.yml) for use with Binder or Google Colab.

## Summary

- The **microsoft/AI-For-Beginners** repository uses an [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) file in the root directory to define all dependencies
- Create the environment once using **`conda env create -f environment.yml`**
- Activate the environment for every new session using **`conda activate ai4beg`**
- Verify activation by checking for **`(ai4beg)`** in your prompt or testing library imports
- Use **`jupyter lab`** to launch notebooks within the activated environment

## Frequently Asked Questions

### What is the exact name of the Conda environment for AI for Beginners?

The environment is named **`ai4beg`**, as defined in the `name` field of the [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml) file located in the repository root. This name appears in your shell prompt when activated.

### Can I use the AI for Beginners curriculum without Conda?

While possible, it is not recommended for local development. The repository includes a [`binder/environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/binder/environment.yml) file for Binder or Colab cloud environments, but local execution requires Conda to manage the specific PyTorch, OpenCV, and Python version pins specified in the main [`environment.yml`](https://github.com/microsoft/AI-For-Beginners/blob/main/environment.yml).

### Why does my shell prompt show (base) instead of (ai4beg)?

The `(base)` indicator means you are still in Conda's default environment. You must run **`conda activate ai4beg`** to switch to the curriculum's dedicated environment before running any notebooks or scripts from the repository.

### How do I deactivate the environment when finished?

Run **`conda deactivate`** to return to your base environment. This removes the `ai4beg` environment from your PATH while preserving the installation for future sessions. You can reactivate it at any time by running the activate command again.