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