From 63b4f322a9d6478ff316ff9438a933eeca814c6f Mon Sep 17 00:00:00 2001
From: channelcat <channelcat@gmail.com>
Date: Sun, 9 Oct 2016 16:00:09 -0700
Subject: [PATCH] Update README.md

---
 README.md | 24 ++++++++++++++++++++++--
 1 file changed, 22 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index a5e913c1..1ecc78e5 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,26 @@
 # Sanic
 
-Python 3.5+ web server that's written to go fast
+Sanic is a Flask-like Python 3.5+ web server that's written to go fast.  It's based off the work done by the amazing folks at magicstack, and was inspired by this article: https://magic.io/blog/uvloop-blazing-fast-python-networking/.
+
+On top of being flask-like, sanic supports async request handlers.  This means you can use the new shiny async/await syntax from Python 3.5, making your code non-blocking and speedy.
+
+## Benchmarks
+
+All tests were run on a AWS medium instance running ubuntu, using 1 process.  Each script delivered a small JSON response and was tested with wrk using 100 connections.  Pypy was tested for falcon and flask, but did not speed up requests.
+
+| Server                       | Requests/sec | Avg Latency |
+| ---------------------------- | ------------:| -----------:|
+| Sanic  (Python 3.5 + uvloop) |       29,128 |      3.40ms |
+| Falcon (gunicorn + meinheld) |       18,972 |      5.27ms |
+| Flask  (gunicorn + meinheld) |        4,988 |     20.08ms |
+| Aiohttp (Python 3.5)         |        2,187 |     56.60ms |
+
+## Usage
+
+## Installation
+ * `python -m pip install git+https://github.com/channelcat/sanic/`
+
+## Final Thoughts:
 
                      ▄▄▄▄▄
             ▀▀▀██████▄▄▄       _______________
@@ -20,4 +40,4 @@ Python 3.5+ web server that's written to go fast
          ▄█             ▐▌
      ▄▄▄▄█▌              ▀█▄▄▄▄▀▀▄
     ▌     ▐                ▀▀▄▄▄▀
-     ▀▀▄▄▀
\ No newline at end of file
+     ▀▀▄▄▀