# Libraries 2.0 installation guide

**URL:** <https://community.particle.io/t/libraries-2-0-installation-guide/27970>\
**Category:** Libs 2.0 Beta\
**Created:** [December 14, 2016, 11:14pm UTC](https://community.particle.io/t/libraries-2-0-installation-guide/27970 "2016-12-14T23:14:42Z")\
**Posts on this page:** 5\
**Page:** 1

<div class="post-metadata">

**Author:** ![will](https://sea2.discourse-cdn.com/flex026/user_avatar/community.particle.io/will/32/23374_2.png) [@will](https://community.particle.io/u/will)\
**Post date:** [December 14, 2016, 11:14pm UTC](https://community.particle.io/t/libraries-2-0-installation-guide/27970/1 "2016-12-14T23:14:43Z")

</div>

Thanks for helping us test **Libraries 2.0** , which is currently in beta in each of our three primary development tools:

- Command Line interface (CLI)
- Desktop IDE (Dev)
- Web IDE (Build)

Please read this [draft documentation about Libraries 2.0](https://github.com/spark/docs/blob/libraries-docs/src/content/reference/libraries.md) before continuing with the installation of these beta tools.

**NOTE** : You need to make sure that your Particle device is running [v0.5.3 or later](https://github.com/spark/firmware/releases/tag/v0.5.3) in order to take advantage of the new Libraries 2.0 architecture. All applications that are migrated to the new project structure required by Libraries 2.0 **will only work on devices running v053 or later** , and migration is non-reversible.

## The purpose of this post is to:

- Provide everyone with the most up-to-date instructions for testing Libraries 2.0 in their Particle IDE of choice (CLI, Dev, Build)
- Serve as a changelog that notifies users of new versions of our beta tools and the improvements that have been made in the new release

##Getting Started

### 1. Web IDE (Build)

**Current version** : Always up-to-date  
**Installation** :  
`http://build-canary.particle.io`

To test Libraries 2.0 with Build, simply log into your Particle account at **[https://build-canary.particle.io](https://build-canary.particle.io)**. All changes will be deployed there in real time–no need to download, update, or install to take advantage of our latest development efforts.

### 2. Desktop IDE (Dev)

**Current version** : v0.2.16  
**Installation** :

To use Libraries 2.0 in Particle Dev, follow these instructions:

1. Open Atom or Particle Dev
2. Reveal command palette (Cmd+Shift+P on macOS and Ctrl+Shift+P on Windows/Linux)
3. Type “install packages” and select **Settings View: Install Packages and Themes**
4. Search for `particle-dev-libraries`
5. Click **Install** next to the package

**Updating** :

To update the Atom package (`particle-dev-libraries`) that facilitates Libraries 2.0, navigate to the Settings screen of Particle Dev by selecting **Atom** \> **Preferences**. Go to the **Updates** tab and click the **Check for Updates** button. This will update your `particle-dev-libraries` package to the most recent version available.

Consult [Readme](https://github.com/spark/particle-dev-libraries#readme) for usage instructions.

### 3. Command Line Interface (CLI)

**Current version** : v1.19.0-libraries.23  
**Installation** :

Installing the Particle CLI is a simple process. Simply type the following npm command into your terminal:

`npm install -g https://github.com/spark/particle-cli/releases/download/v1.19.0-libraries.23/particle-cli-1.19.0-libraries.23.tgz`

---

<div class="post-metadata">

**Author:** ![will](https://sea2.discourse-cdn.com/flex026/user_avatar/community.particle.io/will/32/23374_2.png) [@will](https://community.particle.io/u/will)\
**Post date:** [December 14, 2016, 11:59pm UTC](https://community.particle.io/t/libraries-2-0-installation-guide/27970/2 "2016-12-14T23:59:59Z")

</div>

Pinned on December 14, 2016, 11:59pm UTC



---

<div class="post-metadata">

**Author:** ![will](https://sea2.discourse-cdn.com/flex026/user_avatar/community.particle.io/will/32/23374_2.png) [@will](https://community.particle.io/u/will)\
**Post date:** [December 15, 2016, 12:06am UTC](https://community.particle.io/t/libraries-2-0-installation-guide/27970/3 "2016-12-15T00:06:54Z")

</div>

Closed on December 15, 2016, 12:06am UTC



---

<div class="post-metadata">

**Author:** ![BDub](https://sea2.discourse-cdn.com/flex026/user_avatar/community.particle.io/bdub/32/5137_2.png) [@BDub](https://community.particle.io/u/BDub)\
**Post date:** [December 27, 2016, 4:02pm UTC](https://community.particle.io/t/libraries-2-0-installation-guide/27970/4 "2016-12-27T16:02:49Z")

</div>

I just fixed the link to the beta Web IDE in case you were wondering why it didn’t work 😉 **[https://build-canary.particle.io](https://build-canary.particle.io)**

---

<div class="post-metadata">

**Author:** ![ScruffR](https://sea2.discourse-cdn.com/flex026/user_avatar/community.particle.io/scruffr/32/6952_2.png) [@ScruffR](https://community.particle.io/u/ScruffR)\
**Post date:** [December 27, 2016, 5:53pm UTC](https://community.particle.io/t/libraries-2-0-installation-guide/27970/5 "2016-12-27T17:53:55Z")

</div>

Split this topic on December 27, 2016, 5:53pm UTC

A post was split to a new topic: [Library upload broken? [CLI 1.19.0-libraries.22]](https://community.particle.io/t/library-upload-broken-cli-1-19-0-libraries-22/28168)
