1---
 2title: Toolchains
 3description: "Zed projects offer a dedicated UI for toolchain selection, which lets you pick a set of tools for working with a given language in a current project."
 4---
 5
 6# Toolchains
 7
 8Zed projects include a toolchain selector that lets you choose the tools used for a language in the current project.
 9
10For example, in Python projects, virtual environments define dependencies and interpreter paths. Language servers need that environment to analyze your code correctly.
11With the toolchain selector, you can pick the right virtual environment from a dropdown instead of configuring language server paths manually.
12
13You can even select different toolchains for different subprojects within your Zed project. A definition of a subproject is language-specific.
14In collaborative scenarios, only the project owner can see and modify an active toolchain.
15
16In [remote projects](./remote-development.md), you can use the toolchain selector to control the active toolchain on the SSH host. When [sharing your project](./collaboration/overview.md), the toolchain selector is not available to guests.
17
18## Why do we need toolchains?
19
20The active toolchain is used when launching language servers. Without the correct toolchain, language servers may fail to resolve dependencies, and features like "Go to Definition" or "Code Completions" may not work.
21
22The active toolchain is also relevant when launching a shell in the terminal panel: some toolchains provide "activation scripts" for shells, which make those toolchains available in the shell environment for your convenience. Zed will run these activation scripts automatically when you create a new terminal.
23
24This also applies to [tasks](./tasks.md). Zed runs tasks as if you opened a new terminal tab and ran the task command yourself, so task execution is also affected by the active toolchain and its activation script.
25
26## Selecting toolchains
27
28The active toolchain (if there is one) is shown in the status bar on the right. Click it to open the toolchain selector, or run the command palette action ({#action toolchain::Select}).
29
30Zed will automatically infer a set of toolchains to choose from based on the project you're working with. A default will also be selected on your behalf on a best-effort basis when you open a project for the first time.
31
32Toolchain selection applies to the current subproject, which may be your whole project or just one part of it. In a monorepo, for example, you might choose a different toolchain for each subproject.
33
34## Adding toolchains manually
35
36If automatic detection does not suffice for you, you can add toolchains manually. To do that, click on the "Add toolchain" button in the toolchain selector. From there you can provide a path to a toolchain and set a name of your liking for it.