a ruby gem that provides various wrappers and cli utilities around the open APIs provided by perseus.

currently supported APIS

  • word queries similar to this one
  • a ruby wrapper around the APIs provided here


Add this line to your application's Gemfile:

gem 'perseus'

And then execute:

$ bundle

Or install it yourself as:

$ gem install perseus


$ perseus --help
Usage: perseus [options]

Specific options:
  --generate_json []           Generates the perseus indeces in json format choose fetch method (network -> download, save and index from network, local -> index from already downloaded xml file)
  --word WORD                  Search ancient greek or latin word
  --valid_refs URN             Get valid urn's to query passage content
  --passage URN                Get passage content for given urn
  --title TITLE                Search by title
  --author GROUPNAME/AUTHOR    Search by groupname/author
  -v, --[no-]verbose           Run verbosely

Common options:
  -h, --help                   Show this message
  --version                    Show version


by_author by_title by_word


After checking out the repo, run bin/setup to install dependencies. Then, run rake spec to run the tests. You can also run bin/console for an interactive prompt that will allow you to experiment.

To install this gem onto your local machine, run bundle exec rake install. To release a new version, update the version number in version.rb, and then run bundle exec rake release, which will create a git tag for the version, push git commits and tags, and push the .gem file to


Bug reports and pull requests are welcome on GitHub at


check LICENCE.txt