## Installation

Mithril is available from a variety of sources:

---

### Direct download

You can [download a zip of the latest version version here](mithril.min.zip).

Links to older versions can be found in the [change log](change-log.html).

In order to use Mithril, extract it from the zip file and point a script tag to the `.js` file:

```markup
<script src="mithril.min.js"></script>
```

Note that in order to support older versions of IE, you need to include [some shims](tools.md#internet-explorer-compatibility).

---

### CDNs (Content Delivery Networks)

You can also find Mithril in [cdnjs](http://cdnjs.com/libraries/mithril/) and [jsDelivr](http://www.jsdelivr.com/#!mithril).

Content delivery networks allow the library to be cached across different websites that use the same version of the framework, and help reduce latency by serving the files from a server that is physically near the user's location.

#### cdnjs

```markup
<script src="//cdnjs.cloudflare.com/ajax/libs/mithril/$version/mithril.min.js"></script>
```

#### jsDelivr

```markup
<script src="//cdn.jsdelivr.net/mithril/$version/mithril.min.js"></script>
```

---

### NPM

NPM is the default package manager for [NodeJS](http://nodejs.org/). If you're using NodeJS already or planning on using [Grunt](http://gruntjs.com/) to create a build system, you can use NPM to conveniently keep up-to-date with Mithril versions.

Assuming you have NodeJS installed,  you can download Mithril by typing this:

```
npm install mithril
```

Then, to use Mithril, point a script tag to the downloaded file:

```markup
<script src="/node_modules/mithril/mithril.min.js"></script>
```

---

### Bower

[Bower](http://bower.io) is a frontend package manager built in [NodeJS](http://nodejs.org/). If you're using NodeJS already or planning on using [Grunt](http://gruntjs.com/) to create a build system, you can use Bower to conveniently keep up-to-date with Mithril versions.

Assuming you have NodeJS installed, you can install Bower by typing this in the command line:

```
npm install -g bower
```

And you can download Mithril by typing this:

```
bower install mithril
```

Then, to use Mithril, point a script tag to the downloaded file:

```markup
<script src="/bower_components/mithril/mithril.min.js"></script>
```

---

### Component

[Component](http://component.github.io) is another package manager for [NodeJS](http://nodejs.org/). If you're using NodeJS already or planning on using [Grunt](http://gruntjs.com/) to create a build system, you can use Component to conveniently keep up-to-date with Mithril versions.

Assuming you have NodeJS installed, you can install Component by typing this in the command line:

```
npm install -g component
```

And you can download Mithril by typing this:

```
component install lhorie/mithril
```

Then, to use Mithril, point a script tag to the downloaded file:

```markup
<script src="/components/lhorie/mithril/master/mithril.js"></script>
```

---

### Rails

Jordan Humphreys created a gem to allow integration with Rails:

[Mithril-Rails](https://github.com/mrsweaters/mithril-rails)

It includes support for the [MSX](https://github.com/insin/msx) HTML templating syntax from Jonathan Buchanan.

---

### Github

You can also fork the latest stable project [directly from Github](https://github.com/lhorie/mithril).

If you want to use the bleeding edge version, you can [fork the development repository](https://github.com/lhorie/mithril.js).

Be aware that even though Mithril has tests running in a continuous integration environment, the bleeding edge version might occasionally break. If you're interested in helping improve Mithril, you're welcome to use the bleeding edge version and report any bugs that you find.

In order to update a forked version of Mithril, [follow the instructions on this page](https://help.github.com/articles/syncing-a-fork).

#### Using bleeding edge from NPM

To use the bleeding edge version from npm, use the following command:

```
npm install git://github.com/lhorie/mithril.js#next --save
```