Update README.md

Author: nunomaduro

README.md

@@ -1,19 +1,57 @@
-# Algolia Search API Client for Python
+<p align="center">
+  <a href="https://www.algolia.com">
+    <img alt="Algolia for Python" src="https://raw.githubusercontent.com/algolia/algoliasearch-client-common/master/readme-banner.png" >
+  </a>
 
-[Algolia Search](https://www.algolia.com) is a hosted search engine capable of delivering realtime results from the first keystroke.
+  <h4 align="center">The perfect starting point to integrate <a href="https://algolia.com" target="_blank">Algolia</a> within your Python project</h4>
 
-The **Algolia Search API Client for Python** lets
-you easily use the [Algolia Search REST API](https://www.algolia.com/doc/rest-api/search) from
-your Python code.
+  <p align="center">
+    <a href="https://travis-ci.org/algolia/algoliasearch-client-python"><img src="https://img.shields.io/travis/algolia/algoliasearch-client-python/master.svg" alt="Build Status"></img></a>
+    <a href="https://pypi.org/project/algoliasearch"><img src="https://img.shields.io/pypi/v/algoliasearch.svg" alt="PyPI"></img></a>
+    <a href="https://pypi.org/project/algoliasearch"><img src="https://img.shields.io/pypi/pyversions/ansicolortags.svg" alt="Python versions"></img></a>
+    <a href="https://pypi.org/project/algoliasearch"><img src="https://img.shields.io/pypi/l/ansicolortags.svg" alt="License"></a>
+  </p>
+</p>
 
-[![Build Status](https://travis-ci.org/algolia/algoliasearch-client-python.svg?branch=master)](https://travis-ci.org/algolia/algoliasearch-client-python) [![PyPI version](https://badge.fury.io/py/algoliasearch.svg?branch=master)](http://badge.fury.io/py/algoliasearch)
+<p align="center">
+  <a href="https://www.algolia.com/doc/api-client/getting-started/install/python/" target="_blank">Documentation</a>  •
+  <a href="https://github.com/algolia/algoliasearch-django" target="_blank">Django</a>  •
+  <a href="https://discourse.algolia.com" target="_blank">Community Forum</a>  •
+  <a href="http://stackoverflow.com/questions/tagged/algolia" target="_blank">Stack Overflow</a>  •
+  <a href="https://github.com/algolia/algoliasearch-client-python/issues" target="_blank">Report a bug</a>  •
+  <a href="https://www.algolia.com/support" target="_blank">Support</a>
+</p>
 
+## ✨ Features
 
-## API Documentation
+- Thin & minimal low-level HTTP client to interact with Algolia's API
+- Supports Python: `2.7`, `3.4`, `3.5`, `3.6`, and `3.7`
+- Contains blazing-fast asynchronous methods built on top of the [Asyncio](https://docs.python.org/3/library/asyncio.html)
 
-You can find the full reference on [Algolia's website](https://www.algolia.com/doc/api-client/python/).
+## 💡 Getting Started
 
-## Getting Help
+First, install Algolia Python API Client via the [pip](https://pip.pypa.io/en/stable/installing) package manager:
+```bash
+pip install --upgrade 'algoliasearch>=2.0,<3.0'
+```
 
-- **Need help**? Ask a question to the [Algolia Community](https://discourse.algolia.com/) or on [Stack Overflow](http://stackoverflow.com/questions/tagged/algolia).
-- **Found a bug?** You can open a [GitHub issue](https://github.com/algolia/algoliasearch-client-python/issues).
+Then, create objects on your index:
+```py
+from algoliasearch.search_client import SearchClient
+
+client = SearchClient.create('YourApplicationID', 'YourAPIKey')
+index = client.init_index('your_index_name')
+
+index.save_objects(['objectID': 1, 'name': 'Foo'])
+```
+
+Finally, you may begin searching a object using the `search` method:
+```py
+objects = index.search('Fo')
+```
+
+For full documentation, visit the **[Algolia Python API Client](https://www.algolia.com/doc/api-client/getting-started/install/python/)**.
+
+## 📄 License
+
+Algolia Python API Client is an open-sourced software licensed under the [MIT license](LICENSE.md).