Skip to content

miniforge installation issues #871

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
sstevens2 opened this issue May 14, 2025 · 1 comment
Open

miniforge installation issues #871

sstevens2 opened this issue May 14, 2025 · 1 comment
Assignees

Comments

@sstevens2
Copy link
Contributor

The new python directions are causing lots of problems in the workshop we hosted today.
We only had 5 learners so we were able to solve most of the issues (but not all) before we started but had to start a half hour late. We may really need to think about if it is possible to create some sort of graphical installer that will install mini-forge and setup the environment too.

Some of the issues

  1. Many people had not installed the environment file. Maybe they didn't read the directions well though. Then they still struggled with following them after having learned the unix shell 2 days ago and with an instructor's help.
  2. The environment.yml file doesn't automatically download so they had to know how to save a file in their web browser (which differed by web browser) and most of them didn't know how to do that. Think this is referenced in download html tag for carpentries_environment.yml does not work. #866
  3. Windows users had a problem with after they saved the file, it got a .txt additional extension from Windows. Windows hides this in file explorer and even when you try to rename you can't edit that extension. I was surprised this was a problem but conda gave an error about requirement.txt files needing a name when you try to run the conda create command. So we had to use gitbash to mv the file to a new name without the .txt extension in the end. Perhaps this would be fixed if it automatically downloaded it instead of us saving it as a file.

The learners still struggled with these directions, despite having learned the unix shell a couple days ago. I suspect having not learned the unix shell, asking them to install something in the terminal/mini-forge prompt is very difficult if not impossible for them. I admit to being worried about that prior to the workshop but thought it would be easier after the first day and we shocked by how much help they needed. Not a single learner in the course was able to complete the install directions on their own. A helper also needed help with this install.

@froggleston
Copy link
Contributor

Thanks for this great feedback @sstevens2 - I've raised a PR (#872) to try and address these issues.

@froggleston froggleston self-assigned this May 15, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants