Take a dive with Picky in the Getting Started section.
Fine everything else in the Picky Wiki.

Note that Picky only runs on Ruby 1.9. I recommend RVM for installing and managing Ruby versions.

gem install picky picky-client

The server generates a library example, which you can run right away.

# Generates a directory "app_name"
# with a new Picky project.

picky project app_name

cd app_name
bundle install

rake index

rake start

curl localhost:8080/books/full?query=test

Don’t worry about the strange looking results! The next part (client) will take care of them.

If you’re interested anyway: Results

The client generates an example app for the “library” example backend, using Sinatra.

# Generates a directory "app_name"
# with a new Picky Client Webapp project.

picky-client sinatra app_name

cd app_name
bundle install

unicorn -p 3000

Go to http://localhost:3000/ and try the examples.

You’re probably itching to change the example for your own data. How do you do this?

In the server directory, just type

rake

and it will tell you where to change the server configuration.

Go to http://localhost:3000/configure and the page will show you how to configure your app server.

Right here. I’m happy to help! If something doesn’t work, send/gist me your application.rb and I’ll look into it.

github, twitter, mail