Environments
Anaconda Notebooks is a hosted JupyterLab service that enables you to run JupyterLab notebooks online while simultaneously taking advantage of conda’s robust environment management tools.
With Anaconda Toolbox’s quickstart environments, you can select from a curated collection of data science packages tailored for different analytical needs. These ready-to-install environments eliminate the need to manually configure dependencies and let you to focus on extracting insights from your data rather than managing package compatibility.
Quickstart environments are currently only available for the Local Toolbox.
System requirements
-
Anaconda Navigator version 2.6 or later.
-
Anaconda Toolbox version 4.20.0 or later.
-
An internet connection.
-
An Anaconda.com account.
-
Adequate disk space for environments.
Installation times vary based on your internet connection speed.
Each environment’s size is listed on its quickstart environment card in Anaconda Toolbox.
The
anaconda-ml-ai
environment requires a large amount of disk space. To free up space, we recommend opening a notebook terminal and runningconda clean --all
to free up space after installation.
Installing a quickstart environment
To install a new quickstart environment:
-
Click Create new Environment in Anaconda Toolbox:
-
Click Install on the environment you want to install.
Quickstart environments
Anaconda Toolbox includes four quickstart environments to accelerate your data science workflow with curated package collections:
The python-starter
environment is a simple environment that you can customize to your own needs.
The python-starter
environment is a simple environment that you can customize to your own needs.
The anaconda-2025.04-py3.11
environment includes version-locked packages from the Anaconda metapackage. After installation, verify included packages by running conda list
in a terminal or !conda list
in a notebook cell.
The anaconda-finance
environment includes essential packages for financial analysis, modeling, and visualization of market data.
Tha anaconda-ml-ai
environment includes the core packages necessary for building and training ML/AI models.
Activating an environment
To activate a new environment:
- Open a new Launcher by clicking the blue plus in the top-left corner of the File Browser.
- Select the environment under Notebook.
A new notebook opens with the selected environment assigned as the runtime.
- Open a new Launcher by clicking the blue plus in the top-left corner of the File Browser.
- Select the environment under Notebook.
A new notebook opens with the selected environment assigned as the runtime.
- From Anaconda Toolbox, click Create new Environment.
- Click Open New Notebook on the installed environment card.
A new notebook opens with the selected environment assigned as the runtime.
Click the runtime in the top right, then switch to your desired environment in the Select Runtime modal.
Adding packages to an environment
To add packages to an environment, use the !
syntax to access the system shell and run conda commands. In a notebook cell, run:
To add packages to an environment, use the !
syntax to access the system shell and run conda commands. In a notebook cell, run:
To add packages to an environment via the CLI:
-
Open a terminal from the Launcher, which you can access by clicking the blue plus in the top-left corner.
-
Activate the environment by running the following command:
-
Install the packages you want to add to the environment:
To add packages to an environment in Navigator, follow the steps in the Anaconda Navigator tutorial.
Updating packages
To update a package in your environment, use the !
syntax to access the system shell and run conda commands. In a notebook cell, run:
To update a package in your environment, use the !
syntax to access the system shell and run conda commands. In a notebook cell, run:
To update a packages in your environment via the CLI:
-
Open a terminal from the Launcher, which you can access by clicking the blue plus in the top-left corner.
-
Activate the environment by running the following command:
-
Update the packages:
To update a package in Navigator, follow the steps in the Anaconda Navigator tutorial.
Deactivating environments
It is best practice to deactivate your environment when you are finished working in it.
To deactivate your active environment, run the following command in a notebook cell:
To deactivate your active environment, run the following command in a notebook cell:
To deactivate your active environment:
-
Open a terminal from the Launcher, which you can access by clicking the blue plus in the top-left corner.
-
Run the following command:
Uninstalling environments
We recommend uninstalling quickstart environments from Anaconda Toolbox. Uninstalling a quickstart environment via the CLI or Navigator can result in an “Error starting kernel” message. See the frequently asked question below for details.
To uninstall an environment from Anaconda Toolbox, click Uninstall.
Frequently asked questions
Are package versions specified in the quickstart environments?
No, quickstart environments include a list of packages to install, but rely on the conda solver to select the most up-to-date versions that are compatible with the other packages and their dependencies. After installation, you can verify installed package versions by running !conda list
in a notebook cell in the active environment. You can also view package versions on the Environments page in Navigator.
Can I view security information like CVEs for the installed packages?
While security information isn’t directly accessible, installation security is managed through channel configurations. When installing a quickstart environment, conda uses the channels
list available in your .condarc
file. For business tier customers, this means that you are only able to install quickstart environments if your organization’s policies allow it.
Which channels do I need?
All environments require either the Anaconda defaults
channel or conda-forge
to be included in your .condarc
file. You can update your channels in Navigator or with conda via the CLI.
How long does an environment take to install?
The python-starter
environment, which includes the fewest packages, is the quickest to install and should complete in fewer than five minutes. The anaconda-ai-ml
environment, on the other hand, could take up to 15 minutes to install, due to the large size of some of the packages and complexity of the package dependency resolution process. Exact installation times vary depending on your internet download speeds and hardware specifications.
Can I install more than one quickstart environment?
Yes! You can install one or all of these environments, provided your computer has the available disk space.
How do I stop or interrupt an environment from installing?
To stop or interrupt a quickstart environment during installation, completely close your Jupyter instance (not just the tab or window), then reopen it via Navigator or the command line.
The environment card in Toolbox says the environment is installed, but I don’t see it in the Launcher or runtime selector.
First, try refreshing the browser page. If the environment still doesn’t appear after refreshing, check the Environments page in Navigator to see if it’s available. If the environment is still unavailable after waiting 2 minutes, close all open Jupyter sessions and restart Jupyter from Navigator or the command line.
I got an error message while installing. What should I do?
First, check your .condarc
file and verify that your channels are set to either defaults
or conda-forge
. If your channels are set correctly and you’re still experiencing issues, check with your administrator to see if they have defined any policies that could be blocking installation.
If neither of the above resolves the issue, you can try:
- Refreshing the page
- Checking your internet connection
- Shutting down all running Jupyter kernels and restarting your Jupyter instance
If I’ve uninstalled an environment, can I continue working?
You can continue working in the same notebook, but you’ll need to select an existing runtime. This can be done through the runtime selector, the Launcher, or by using the terminal. Any previously executed cells might need to be re-run in the new runtime.
I’m getting an error saying, “Error starting kernel: [Errno 2] No such file or directory”.
Uninstalling a quickstart environment via the CLI or Navigator can result in this message, as the Jupyter kernel references won’t be properly removed when the environment is deleted.
To resolve this issue:
-
Open Anaconda Prompt (Terminal in macOS/Linux)
-
Run:
-
Find the name of the quickstart environment you deleted.
-
Then run: