Skip to main content

RESTful (micro)server that can generate an API in minutes.

Project description


Pypi Travis build Codacy grade Codacy coverage Docs

A micro REST API meant to be used almost out of the box with other microservices.

It kickstarts you by providing a simple way to build a backend and expose it. Efesto uses PostgreSQL and JWTs for authentication.

Efesto follows the UNIX principle of doing one thing and well, leaving you the freedom of choice about other components (authentication, caching, rate-limiting, load balancer).


Install efesto, possibly in a virtual environment:

pip install efesto

Create a postgresql database and export the database url:

export DB_URL=postgres://postgres:postgres@localhost:5432/efesto

Export the jwt secret:

export JWT_SECRET=secret

Populate the db:

efesto install

Create an admin:

efesto create users tofu --superuser

Now you can start efesto, with either uwsgi or gunicorn:

gunicorn ""

Efesto should now be running:

curl http://localhost:8000/version

Read the complete documentation to find out more.


Docker images are available in the hub:

  • strangemachines/efesto:latest
  • strangemachines/efesto:latest-meinheld
  • strangemachines/efesto:2.3
  • strangemachines/efesto:2.3-meinheld
  • strangemachines/efesto:2.2
  • strangemachines/efesto:2.1


Efesto performs at about 300 requests/second on the smallest digital ocean droplet, for requests that include JWT authentication, fetching data and printing out JSON.

You have seen 100k requests benchmarks, but don't be fooled: most benchmarks from authors are made so that their package comes to the top and do not reflect real conditions.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for efesto, version 2.3.4
Filename, size File type Python version Upload date Hashes
Filename, size efesto-2.3.4-py3-none-any.whl (58.6 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size efesto-2.3.4.tar.gz (37.7 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page