Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
an HTTP resource kit for Python

Merge pull request #131 from faassen/patch-2

Language improvements.
latest commit 5aaac485ce
Benoit Chesneau authored
Failed to load latest commit information.
debian [packaging] Fix debian control with missing tabulation in dependancies
doc Language improvements.
examples case where the socket has been closed before we read headers
restkit bump to 4.2.2
scripts prepare setup for py3
tests Fix '' to better conform to OAuth spec.
.gitignore Add support for tox (
.hgignore I use hggit
.travis.yml improve setup
LICENSE bump license and some changes for readthedocs add requirements
NOTICE bump license and some changes for readthedocs
README.rst Typo
THANKS add Marc Abramowitz to THANKS
TODO.txt update the TODO add wsgi_proxy
buildout.cfg add requirements
main Added gevent_pool and fix eventlet. Documentation updated.
requirements.txt bump socketpoool requirement
requirements_dev.txt bump socketpoool requirement
setup.cfg that's not doctests anyway bump socketpoool requirement



Restkit is an HTTP resource kit for Python. It allows you to easily access to HTTP resource and build objects around it. It's the base of couchdbkit a Python CouchDB framework.

Restkit is a full HTTP client using pure socket calls and its own HTTP parser. It's not based on httplib or urllib2.


  • Full compatible HTTP client for HTTP 1.0 and 1.1
  • Threadsafe
  • Use pure socket calls and its own HTTP parser (It's not based on httplib or urllib2)
  • Map HTTP resources to Python objects
  • Read and Send on the fly
  • Reuses connections
  • Eventlet and Gevent support
  • Support Chunked transfer encoding in both ways.
  • Support Basic Authentification and OAuth.
  • Multipart forms and url-encoded forms
  • Streaming support
  • Proxy handling
  • HTTP Filters, you can hook requests in responses with your own callback
  • Compatible with Python 2.x (>= 2.6)



restkit requires Python 2.x superior to 2.6 (Python 3 support is coming soon)

To install restkit using pip you must make sure you have a recent version of distribute installed:

$ curl -O
$ sudo python
$ easy_install pip

To install from source, run the following command:

$ git clone
$ cd restkit
$ pip install -r requirements.txt
$ python install

From pypi:

$ pip install restkit


restkit is available under the MIT license.

Something went wrong with that request. Please try again.