1## Installation 2 3### Requirements 4 5 * [Emacs](https://www.gnu.org/software/emacs/) 24.4 or later 6 * [Elixir](http://elixir-lang.org/) 1.0 or later 7 8### Installation via package.el 9 10`package.el` is the built-in package manager in Emacs. 11 12Alchemist.el is available on the two major `package.el` community maintained repos - [MELPA Stable](http://stable.melpa.org) and [MELPA](http://melpa.org). 13 14You can install `Alchemist` with the following command: 15 16<kbd>M-x package-install [RET] alchemist [RET]</kbd> 17 18or by adding this bit of Emacs Lisp code to your Emacs initialization file 19(`.emacs` or `init.el`): 20 21```el 22(unless (package-installed-p 'alchemist) 23 (package-install 'alchemist)) 24``` 25 26If the installation doesn't work try refreshing the package list: 27 28<kbd>M-x package-refresh-contents [RET]</kbd> 29 30Keep in mind that MELPA packages are built automatically from 31the `master` branch, meaning bugs might creep in there from time to 32time. Never-the-less, installing from MELPA is the recommended way of 33obtaining Alchemist, as the `master` branch is normally quite stable and 34"stable" (tagged) builds are released somewhat infrequently. 35 36With the most recent builds of Emacs, you can pin Alchemist to always 37use MELPA Stable by adding this to your Emacs initialization: 38 39```el 40(add-to-list 'package-pinned-packages '(alchemist . "melpa-stable") t) 41``` 42 43### Via el-get 44 45[el-get](https://github.com/dimitri/el-get) is another popular package manager for Emacs. If you're an el-get 46user just do <kbd>M-x el-get-install [RET] alchemist [RET]</kbd>. 47 48### Manual 49 50You can install Alchemist manually by placing Alchemist on your `load-path` and 51`require` ing it. Many people favour the folder `~/.emacs.d/vendor`. 52 53```el 54(add-to-list 'load-path "~/.emacs.d/vendor/alchemist.el/") 55(require 'alchemist) 56``` 57