Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Ferret: the extensible information retrieval library for ruby.
C Ruby Other
branch: master
Failed to load latest commit information.
art Added gimp file for Ferret web badge.
c Fixed type conversion error in C tests
ruby Fixed locking bug in tests in 1.9.1
.gitignore Tweaks to .gitignore files
DOCUMENTATION_STANDARDS * removed obsolete Perl makefile generator
MIT-LICENSE Finally moved the experimental version of ferret into the proper ferr…
README Finally moved the experimental version of ferret into the proper ferr…
TODO Started detailed documentation of the QueryParser
smoke_test.rb Finally moved the experimental version of ferret into the proper ferr…



Ferret is an information retrieval library in the same vein as Apache Lucene[1].
Originally it was a full port of Lucene but it now uses it's own file format
and indexing algorithm although it is still very similar in many ways to
Lucene. Everything you can do in Lucene you should be able to do in Ferret.

For more information on Ferret, please visit the website:

[1] (


    Ferret is written in C for speed. The actual C code should be fairly easy
    to use in an application or bindings to a language other than Ruby.

    This directory contains the Ruby bindings and tests. See ruby/README for
    information on installing Ferret's Ruby bindings

    If you would like to ensure that ferret keeps working on your system, add
    this method to a cron daemon to run as often as you like. Every time I
    check in a new version of Ferret, this script will pull down the changes
    from the repository and run all of the unit tests (C and Ruby), notifying
    me if anything is broken. The more people running this script the more
    stable ruby will be.


To contribute code, please contact Dave Balmain at or submit
a ticket to the Ferret website[2]. If you would like to contribute financially,
please also visit the Ferret website:



[<b>David Balmain</b>] {}


[The Apache Software Foundation (Doug Cutting and friends)] Original Apache
Lucene. There have also been many other contributers to Ferret. I will start 
to record them on the Ferret website.


Ferret is available under an MIT-style license.

Something went wrong with that request. Please try again.