docs: Add note about toolchain selection for Python REPL (#60549)

# Objective

Improve documentation to inform about toolchain in repl session and
avoid issues like https://github.com/zed-industries/zed/issues/60465

## Solution

- Add a note in documentation about using toolchain for change python
enviroment

## Self-Review Checklist:

- [x] I've reviewed my own diff for quality, security, and reliability

Release Notes:

- N/A

---------

Co-authored-by: Kunall Banerjee <hey@kimchiii.space>
This commit is contained in:
Victor RatonandKunall Banerjee authored and GitHub committed 2026-07-30 03:19:59 +00:00
1 parent b76a6228f5
commit 7af13b3ca8
1 file changed
+2 -6
+2 -6
View File
@@ -73,12 +73,6 @@ style.use('ggplot')
#### Global environment
<div class="warning">
On macOS, your system Python will _not_ work. Either set up [pyenv](https://github.com/pyenv/pyenv?tab=readme-ov-file#installation) or use a virtual environment.
</div>
To set up your current Python to have an available kernel, run:
```sh
@@ -102,6 +96,8 @@ pip install ipykernel
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"
```
> Note: **On macOS, your system Python will _not_ work**. Either set up [pyenv](https://github.com/pyenv/pyenv?tab=readme-ov-file#installation) or use a virtual environment. Zed uses separate selections for the Python [toolchain](./configuring-languages.md#toolchains) and REPL kernel. If diagnostics differ from the REPL, align the toolchain with the kernel using {#action toolchain::Select}. Read more about the [toolchain selector for Python](./languages/python.md#selecting-a-toolchain).
### R (Ark Kernel) {#r-ark}
Install [Ark](https://github.com/posit-dev/ark/releases) by downloading the release for your operating system. For example, for macOS just unpack `ark` binary and put it into `/usr/local/bin`. Then run: