Eve. The Simple Way to REST

Version 0.7.3.

https://img.shields.io/pypi/v/eve.svg?style=flat-square https://img.shields.io/travis/pyeve/eve.svg?branch=master&style=flat-square https://img.shields.io/pypi/pyversions/eve.svg?style=flat-square https://img.shields.io/badge/license-BSD-blue.svg?style=flat-square

Eve is an open source Python REST API framework designed for human beings. It allows to effortlessly build and deploy highly customizable, fully featured RESTful Web Services.

Eve is powered by Flask and Cerberus and it offers native support for MongoDB data stores. Support for SQL, Elasticsearch and Neo4js backends is provided by community extensions.

The codebase is thoroughly tested under Python 2.6-3.6, and PyPy.

Eve is Simple

from eve import Eve

app = Eve()

The API is now live, ready to be consumed:

$ curl -i http://example.com/people
HTTP/1.1 200 OK

All you need to bring your API online is a database, a configuration file (defaults to settings.py) and a launch script. Overall, you will find that configuring and fine-tuning your API is a very simple process.

Live demo

Check out the live demo. If using a browser you will get XML back. For JSON in the browser, you might want to install Postman or similar extension and then set the Accept request header to application/json. If you are a CLI user (and you should), curl is your friend. The source code will show you how easy it is to run an API with Eve. You will also find usage examples for all common use cases (GET, POST, PATCH, DELETE and more). There is also a simple client app available.

Development Version

If you are on python-eve.org then you are looking at the documentation of the development version. Looking for last release docs? Follow this link.


This documentation is under constant development. Please refer to the links on the sidebar for more information.