Skip to content
A RESTful CouchDB client based on Heroku's RestClient and Couch.js - you want the version at
Ruby Other
Find file
New pull request
Pull request Compare This branch is 71 commits ahead, 1 commit behind jchris:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

CouchRest: CouchDB, close to the metal

Please use the copy of CouchRest found at

CouchRest is based on CouchDB's couch.js test library, which I find to be concise, clear, and well designed. CouchRest lightly wraps CouchDB's HTTP API, managing JSON serialization, and remembering the URI-paths to CouchDB's API endpoints so you don't have to.

CouchRest is designed to make a simple base for application and framework-specific object oriented APIs. CouchRest is Object-Mapper agnostic, the parsed JSON it returns from CouchDB shows up as subclasses of Ruby's Hash. Naked JSON, just as it was mean to be.

Note: CouchRest only support CouchDB 0.9.0 or newer.

Easy Install

$ sudo gem install couchrest

Relax, it's RESTful

CouchRest rests on top of a HTTP abstraction layer using by default Heroku’s excellent REST Client Ruby HTTP wrapper. Other adapters can be added to support more http libraries.

Running the Specs

The most complete documentation is the spec/ directory. To validate your CouchRest install, from the project root directory run rake, or autotest (requires RSpec and optionally ZenTest for autotest support).



Check the wiki for documentation and examples


Please post bugs, suggestions and patches to the bug tracker at

Follow us on Twitter:

Also, check

Ruby on Rails

CouchRest is compatible with rails and can even be used a Rails plugin. However, you might be interested in the CouchRest companion rails project:

Something went wrong with that request. Please try again.