Overview

This section will walk you through installing the Emacs application, necessary packages, as well as the IQSS configuration.

These instructions are for macOS. The keyboard shortcuts, the installers, and the Homebrew steps all assume it.

In preparation for installing Emacs, there are other programs that we also recommend to install. Please refer to our documentation for useful programs to install prior to Emacs. This page includes links to external download sites for programs such as R, a TeX distribution, and Git. On macOS install MacTeX, which is the standard distribution there.

In fact, if you do not install some of these (or if you have not previously installed some of these), you may run into problems when loading our Emacs configuration. Git in particular should be installed first: some packages are fetched with it, and the Copilot integration needs it.

For this process, we will teach you how to use the command line in the terminal. However, there will also be external links for many of the download options if you are not wholly comfortable in the terminal, or find yourself running into problems.