Skip to content

Commit 0a7718a

Browse files
committed
Updated install instructions.
1 parent f6381ba commit 0a7718a

File tree

1 file changed

+14
-4
lines changed

1 file changed

+14
-4
lines changed

readme.markdown

Lines changed: 14 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -73,10 +73,10 @@ If you encounter issues, get as far as you can, and we will work through them in
7373

7474
### Install software
7575

76-
1. Install [Anaconda, Python 3.8 version](https://www.anaconda.com/distribution/).
76+
1. Install [Anaconda, Python 3.9 version](https://www.anaconda.com/distribution/).
7777
1. (experts-only alternative) Install miniconda instead of the GUI version. While there are direct download versions, you would typically use a package manager (e.g., brew on macOS, apt on Ubuntu).
7878

79-
**Note:** If you have a new Apple Silicon Mac, the easiest thing to do is to follow the instructions above, which will install Anaconda using Rosetta 2 (see this [Anaconda blog post](https://www.anaconda.com/blog/apple-silicon-transition)). They're fantastic computers, though this is one area where the native software is taking a bit to catch up.
79+
**Note:** If you have a new Apple Silicon Mac, the easiest thing to do is to follow the instructions above, which will install Anaconda using Rosetta 2 (see this [Anaconda blog post](https://www.anaconda.com/blog/apple-silicon-transition)). There is a native version available, though it does not yet have the Anaconda Navigator graphical user interface. That omission is fine once you know your way around, but it's helpful for learning.
8080

8181

8282
### Importing the Anaconda environment
@@ -85,8 +85,8 @@ If you encounter issues, get as far as you can, and we will work through them in
8585
1. On the left, click Environment.
8686
1. At the bottom of the resulting main window, click Import.
8787
1. In the resulting popup, click the folder icon, navigate to the `environment.yml` file, and click Open.
88-
1. Back in the import popup, the environment name should be filled in automatically from the file, `carmapy` in this case. Click Import.
89-
1. Wait for the packages for the environment to be downloaded and installed. This could take a few minutes.
88+
1. Back in the import popup, the environment name should be filled in automatically from the file, `carmapy` in this case. If not, the default is `environment`, and you can replace that with `carmapy`. Click Import.
89+
1. Wait for the packages for the environment to be downloaded and installed. This could take a several minutes.
9090

9191

9292
### Install TextBlob text corpora
@@ -111,6 +111,16 @@ You can run the notebook that we will use in the first session as a test of whet
111111
1. The notebook should run quickly, and you should not see errors. Note: the single most common issue with any import errors at the top is that you have not selected the environment in step 3 above. You need to do that before launching Jupyter Lab, and a subsequent change will not affect the already--running Jupyter Lab.
112112

113113

114+
### (optional) Install VS Code
115+
116+
I will generally do walkthroughs using VS Code for notebooks instead of the Jupyter Lab interface.
117+
VS Code is an open-source programming text editor platform, developed principally by Microsoft, that works with many languages (including Python and R), and it has nice built-in Jupyter Notebook support.
118+
There are a number of conveniences that come with using Jupyter this way, so I suggest installing and using it instead of the web interface.
119+
120+
1. Download and install [VS Code](https://code.visualstudio.com).\
121+
1. (optional) As time permits, do the built-in "Get Started with VS Code" walkthrough. It will give you an introduction to some of the nice features and customizability of VS Code.
122+
123+
114124
## About Jason
115125

116126
Jason T. Kiley is an Assistant Professor at Clemson University.

0 commit comments

Comments
 (0)