--- layout: default title: Download - Ruby Facets ---

# A Dependency of Choice

Ruby Facets is a vast resource for Ruby developers.
Whether it is to borrow code or as a direct gem dependency, Ruby Facets is here to serve the Ruby development community to create better, more robust software.

# Installation

Facets can be dowloaded and installed easily using RubyGems:

    gem install facets

Gems will automatically generate rdocs on installation. Unfortunately the Gem generated rdocs are very poor --in fact Facets only allows them to be generated to ensure the creation of ri docs (ruby api index files). We recommend instread that you use the pre-generated rdocs provided in the doc/ directory which are much more user-friendly.

If you prefer to install from source. You can download the `.tgz` package from RubyForge and follow the standard procedure:

          $ tar -xvzf facets-3.0.0.tgz
          $ cd facets-3.0.0
          $ ruby setup.rb

The last step may require super-user permissions (eg. use `sudo`).

# Packages

Facets' distribution packages are hosted on RubyForge.org. You can download any of the distributed packages directly from the Facets project site:

http://rubyforge.org/frs/?group_id=804

# Ruby

Of course, to use Facets you also need Ruby. We recommend Ruby 1.8.6 for use with Facets. Facets is mostly compatible with Ruby 1.9, but it will be a little while yet before Ruby 1.9 is stable enoguh to ensure 100% usability.

Source: Compile it yourself.
Windows installer: Includes Ruby, popular extensions and editor.
OS X 10.5+ Ruby is already included!