topic Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong? in Python Questions

Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

mfcallahan — Tue, 11 Oct 2022 13:59:12 GMT

I'm attempting to configure VS Code for ArcPy/ArcGIS Pro development, and things have been going ok so far, however I have run into an issue I am not sure how to resolve. I'm also curious to hear how other in the community have configured VS Code - I want to make sure I'm not way off base. Here is how I have configured VS Code:

I first cloned a Python environment from the ArcGIS Pro Package Manager, and then set the location of the Python interpreter in VS Code to the "python.exe" in my cloned env (which for me, was in this folder: %LocalAppData%\ESRI\conda\envs\my-cloned-environment\python.exe).

And that was actually all I needed to do in order to run and debug a script. I am able to create a new Python debugging configuration in VS Code, set breakpoints step through the code, and get IntelliSense on all ArcPy modules & methods. However, there is still something I am not fully understanding, I think..

On VS Code Terminal launch, I get the following error:

That looks to me like the system PATH environment variable has not been configured for Conda, and Powershell does not recognize the conda command. The Conda docs actually recommend not modifying the PATH env var, but if I do, I can resolve the error above, and the conda command is recognized.

However, that yields another error, "CommandNotFoundError: Your shell has not been properly configured to use ‘conda activate’.”

Looking at the error message, I see that it is saying to run command conda init powershell, however, this also yields an error an I am stuck at this point, unsure how to proceed. Running VS Code as admin did not resolve the issue.

To further compound my confusion, I came across this in the Esri docs saying "propy.bat" or "proenv.bat" should be used, but I don't know how I would integrate with VS Code:

https://pro.arcgis.com/en/pro-app/latest/arcpy/get-started/using-conda-with-arcgis-pro.htm

I'm curious to hear how other VS Code users have their local development environment configured, if you ran into any of these issues, how you resolved them, etc. Or am I just completely way off base in my methods and attempts to get VS Code configured lol??

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

EarlMedina — Tue, 11 Oct 2022 17:47:23 GMT

I've gotten this to work like so:

Edit the VS Code settings.json file located here on Windows: C:\Users\[YOUR_USER]\AppData\Roaming\Code\User\settings.json

From there, update the line with "python.pythonPath" to

"python.pythonPath": "C:\\Program Files\\ArcGIS\\Pro\\bin\\Python\\Scripts\\propy.bat"

If for some reason that does not work, I have gotten it to work by pointing to the desired cloned environment directly like this:

"python.pythonPath": "C:\\Users\\[YOUR_USER]\\AppData\\Local\ESRI\\conda\\envs\\[NAME_OF_ENV]\\python.exe"

Hope this helps!

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

Brian_Wilson — Tue, 11 Oct 2022 17:48:12 GMT

VSCODE understands Conda, but you have to tell it how to find conda.

Edit->Preferences

Search for conda and you should see "Python: Conda Path"

If you still have the Python path set you should probably clear that.

I set the "Conda path" to C:\Program Files\ArcGIS\Pro\bin\Python\Scripts so that VSCode can find conda.

After setting the Conda path, I restart VSCode and I note in the task bar I can see "Discovering Python environments" flash by and then do F1->Python: Select Interpreter.

Now it shows me the list of Conda environments, which on my computer looks like this.

It found both my Esri environments and one(s) set up using "miniconda" which I have separately installed (you don't need miniconda) Note I installed "miniconda" because it works better for me from Bash shells so it finds that version of Python as well. (Having both the Esri conda and minconda installed works fine.)

Next I add the Scripts folder to my environment PATH settings,

Now I can restart VSCode, open a Powershell in a Terminal and run "conda info". Output looks like this on my computer:

PS C:\Users\bwilson\Documents\source\arcgis_tools> conda info active environment : arcgispro-py3 active env location : C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3 user config file : C:\Users\bwilson\.condarc populated config files : C:\Program Files\ArcGIS\Pro\bin\Python\.condarc C:\Users\bwilson\.condarc conda version : 4.9.2 conda-build version : not installed python version : 3.7.11.final.0 virtual packages : __cuda=11.6=0 __win=0=0 __archspec=1=x86_64 base environment : C:\Program Files\ArcGIS\Pro\bin\Python (read only) channel URLs : https://conda.anaconda.org/esri/win-64 https://conda.anaconda.org/esri/noarch https://conda.anaconda.org/conda-forge/win-64 https://conda.anaconda.org/conda-forge/noarch https://repo.anaconda.com/pkgs/main/win-64 https://repo.anaconda.com/pkgs/main/noarch https://repo.anaconda.com/pkgs/r/win-64 https://repo.anaconda.com/pkgs/r/noarch https://repo.anaconda.com/pkgs/msys2/win-64 https://repo.anaconda.com/pkgs/msys2/noarch package cache : C:\Users\bwilson\AppData\Local\ESRI\conda\pkgs C:\Program Files\ArcGIS\Pro\bin\Python\pkgs C:\Users\bwilson\.conda\pkgs envs directories : C:\Users\bwilson\AppData\Local\ESRI\conda\envs C:\Program Files\ArcGIS\Pro\bin\Python\envs C:\Users\bwilson\.conda\envs platform : win-64 user-agent : conda/4.9.2 requests/2.25.1 CPython/3.7.11 Windows/10 Windows/10.0.22621 administrator : False netrc file : None offline mode : False

Almost there, when I try to do the normal activate for example "conda activate arcgispro29" it complains that I have not done "conda init" yet. If I do that, I restart VSCODE again, and find out it screws up my startup file. To recover I delete the startup file it created, C:\Users\bwilson\Documents\WindowsPowerShell\profile.ps1

Ignore the "conda init" thing by using the scripts that Esri installed, first run "proenv" then "activate".

PS C:\Users\bwilson\Documents\source\arcgis_tools> proenv (arcgispro-py3) C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3>activate arcgispro29 (arcgispro29) C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3>conda info (arcgispro29) C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3>conda info active environment : arcgispro29 active env location : C:\Users\bwilson\.conda\envs\arcgispro29 (etc etc)

so that seems to get us where you need to be. You can use Python from the VSCode debugger (F5) and you can also activate an environment in a shell if you want; you need that to install additional packages and manage conda from the command line. Like, to create new environments.

I could also tell you how I set up miniconda so that it works in Bash but you did not ask that.... I avoid PowerShell as much as possible. Personal preference.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

mfcallahan — Tue, 11 Oct 2022 22:59:56 GMT

You da man, @Brian_Wilson - thanks for replying, this worked for me! I had a very frustrating call with an Esri tech support representative for an hour trying to work thru this, but it ultimately ended it with a "we don't support this" answer and the ticket being closed 😑 I probably wasn't communicating things effectively to support, but Pro/ArcPy/Conda and actually using them is something that is so under-documented that even Esri's staff can't answer questions about how this type of stuff is configured..

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

Brian_Wilson — Tue, 11 Oct 2022 23:05:32 GMT

Hey you're welcome!

VSCode is the only Microsoft tool I can say I am actually fond of. (Well-- I did like MSC a lot but that was in 1985.)

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

mfcallahan — Tue, 11 Oct 2022 23:20:53 GMT

Ha! Well, I'll give some credit where credit is due..not a lot of software companies have made a game that still works flawlessly 32 years later (on an operating system that didn't even exist in 1990!)

MS Solitatire (1990) running on Pop!_OS 22.04 (2022)

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

I_AM_ERROR — Wed, 12 Oct 2022 08:45:31 GMT

I know this isn't directly related to the question at hand, but since there are like-minded VSCode users in this thread perhaps it'll be allowed...

Is anyone successfully debugging in VS using attach to process w/ ArcGIS Pro? I know there is some documentation for Visual Studio, and i've seen some issues/discussions on GitHub related to it but I haven't managed to get it working.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

mfcallahan — Wed, 12 Oct 2022 13:40:57 GMT

Yes, that would be amazing, but everything I've read while investigating the same thing seems to indicate that it is not possible.. If I could have a workflow similar to Visual Studio ArcGIS Pro Add-in development with VS Code & Python by attaching the debugger to the running arcgispro.exe instance I would be so happy 😀

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

I_AM_ERROR — Wed, 12 Oct 2022 20:26:58 GMT

Just submitted an idea if anyone else wants to dogpile on it 🙂

Debug ArcGIS Pro python tools in VS Code using Att... - Esri Community

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

mfcallahan — Wed, 12 Oct 2022 22:04:29 GMT

If PyCharm can do this, there's got to be a way for VS Code to do this as well 🤔 I would definitely love to see an official Esri "VS Code ArcGIS Pro Debugger extension"

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

cdevault_pickett — Tue, 15 Nov 2022 15:21:12 GMT

Thank you for this, I've been struggling with this annoyance for a while. I feel like I am so close, but I am still getting the error the original poster had where the term conda is not recognized after following your directions. I was able to set the Conda path and add that path as a system environment variable. But I still cannot run conda init, I get the same error still. Any other ideas? I'm using the standard python installation from Pro 2.9 (no clones or anything).

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

Brian_Wilson — Tue, 15 Nov 2022 22:50:18 GMT

Does VSCODE see your conda environments? You should be able to see them if you do F1->Python: Select Interpreter

Mine look different probably because I have a separate install of Miniconda too.

I don't have much use for PowerShell, I use bash most of the time. But I find Powershell can only find conda if I run the proenv script first.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

cdevault_pickett — Wed, 16 Nov 2022 16:33:49 GMT

Thanks for the reply, I think it has something to do with permissions or something on my work computer. I followed the steps exactly on my personal computer and it works as expected. If I figure it out I'll reply here.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

Brian_Wilson — Wed, 16 Nov 2022 17:18:50 GMT

I have a hard time letting go of problems before they are solved. 🙂

Back when the ArcGIS Pro version of conda was very out of date, I started using Miniconda in parallel with the ArcGIS Conda. Since then I just find it works better for me to use both.

From the installer page: "On Windows, macOS, and Linux, it is best to install Miniconda for the local user, which does not require administrator permissions and is the most robust type of installation."

So for example right now I have the ArcGIS version, not on my path so typing entire path,

$ /c/Program\ Files/ArcGIS/Pro/bin/Python/Scripts/conda info active environment : C:\tools\miniconda3\envs\arcgis-example active env location : C:\tools\miniconda3\envs\arcgis-example shell level : 0 user config file : C:\Users\bwilson\.condarc populated config files : C:\Program Files\ArcGIS\Pro\bin\Python\.condarc C:\Users\bwilson\.condarc conda version : 4.9.2

and the Miniconda version, on my shell path so I can type directly "conda"

conda activate arcgis-example (arcgis-example) bwilson@04-2288 MINGW64 /c/Users/bwilson/.conda $ conda info active environment : arcgis-example active env location : C:\tools\miniconda3\envs\arcgis-example shell level : 1 user config file : C:\Users\bwilson\.condarc populated config files : C:\Users\bwilson\.condarc conda version : 4.12.0

And I set conda path in VSCODE to point at the miniconda version

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

JasonJordan00 — Wed, 30 Nov 2022 14:58:17 GMT

After following Brian's answer above I was also able to add the following to my settings.json file and VS Code finally starts up my Pro env in the terminal by default without the conda init warning. I'm using command prompt as my default shell.

"python.terminal.activateEnvironment": false "terminal.integrated.profiles.windows": { "PowerShell": { "source": "PowerShell", "icon": "terminal-powershell" }, "Command Prompt": { "path": [ "${env:windir}\\Sysnative\\cmd.exe", "${env:windir}\\System32\\cmd.exe" ], "args": [ "/k", "C:/Program Files/ArcGIS/Pro\\bin/Python/Scripts/proenv.bat"], "icon": "terminal-cmd" }, "Git Bash": { "source": "Git Bash" } }

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

SFM_TravisBott — Fri, 13 Jan 2023 20:04:03 GMT

I am also having trouble executing - I don't even seem to have the Python: Conda Path option when selecting settings. Should I be setting the interpreter to conda.exe rather than python.exe packaged with Pro? I also have no other environments available in C:\Users\{User}\AppData\Local\ESRI\conda\envs.

Feeling like a bit of a numbskull here trying to get going, especially when their documentation makes it seem like it should be so simple.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

Brian_Wilson — Sat, 14 Jan 2023 00:32:37 GMT

There are tabs on the settings page, one for "User" and one for "Workspace". When I switch to "Workspace", the "Python: Conda Path" setting disappears. Maybe you clicked on Workspace? I guess they don't want you to have a conda set different in a workspace than in your global (user) settings so they don't let us do that.

Setting the python path to conda.exe wont work. Don't do that.

If you have conda working, like at command line, you can see where your environments are stored. They can be in different places. (Anyplace, really). Each environment is a folder with Python and packages and other stuff stored in it.

So it's possible for C:\Users\{User}\AppData\Local\ESRI\conda\envs to be EMPTY and you still have envs... this is what my computer shows in "envs directories" right now when I do "conda info"

envs directories : C:\Program Files\ArcGIS\Pro\bin\Python\envs C:\Users\bwilson\AppData\Local\ESRI\conda\envs C:\Users\bwilson\Miniconda3\envs C:\Users\bwilson\.conda\envs C:\Users\bwilson\AppData\Local\conda\conda\envs

It's including some directories that I added by editing my .condarc config file. My .condarc has this in it. I think the other folders are added because of where I have my conda.exe installed (C:\Users\bwilson\Miniconda3) and the .conda folder my home directory (C:\Users\bwilson\.conda)

envs_dirs:
- C:/Program Files/ArcGIS/Pro/bin/Python/envs
- C:/Users/bwilson/AppData/Local/ESRI/conda/envs

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

SFM_TravisBott — Tue, 17 Jan 2023 15:19:18 GMT

Thank you for the reply. Very helpful. I am not particularly savvy but was able to get mine working without really understanding what I did. The first post in this link, and the page it links to, were helpful.

I typed this below into the command prompt....

conda init powershell

...this succeeded in letting me actually run code, though it would still show an error at the initialization of any script.

Then I made the settings change (in VS code, Terminal: Select Default Profile), setting the terminal to command prompt.

Everything runs smoothly now.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

AlexRobinson13 — Fri, 17 Feb 2023 23:42:34 GMT

Hey there,

I followed your instructions and now I am getting these messages. Any clues for me?

PS C:\Users\AROBINSO> conda activate arcgispro-py3

CommandNotFoundError: Your shell has not been properly configured to use 'conda activate'.
If using 'conda activate' from a batch script, change your
invocation to 'CALL conda.bat activate'.

To initialize your shell, run

$ conda init <SHELL_NAME>

Currently supported shells are:
- bash
- cmd.exe
- fish
- tcsh
- xonsh
- zsh
- powershell

See 'conda init --help' for more information and options.

IMPORTANT: You may need to close and restart your shell after running 'conda init'.

Re: Trying to configure ArcGIS Pro/ArcPy + VS Code, but can't activate conda environment - where am I going wrong?

cdevault_pickett — Fri, 24 Mar 2023 20:18:02 GMT

@Brian_Wilson Thanks for the help back in November but I'm just now circling back to this. I've got things to the point where I receive a similar message that @AlexRobinson13 is experiencing.

PS C:\Users\cdevault> activate PS C:\Users\cdevault> conda activate "C:\Program Files\ArcGIS\Pro\bin\Python\envs\arcgispro-py3" CommandNotFoundError: Your shell has not been properly configured to use 'conda activate'. If using 'conda activate' from a batch script, change your To initialize your shell, run $ conda init <SHELL_NAME> Currently supported shells are: - bash - cmd.exe - fish - tcsh - xonsh - zsh - powershell See 'conda init --help' for more information and options. IMPORTANT: You may need to close and restart your shell after running 'conda init'. PS C:\Users\cdevault> & "C:/Program Files/ArcGIS/Pro/bin/Python/envs/arcgispro-py3/python.exe" c:/Users/cdevault/Desktop/Print.py test PS C:\Users\cdevault>