diff --git a/README.md b/README.md
new file mode 100644
index 0000000..559121a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,73 @@
+dpkt
+====
+
+fast, simple packet creation / parsing, with definitions for the basic
+TCP/IP protocols
+
+![docs](https://readthedocs.org/projects/dpkt/badge/?style=flat:target:https://readthedocs.org/projects/dpkt)
+![travis](http://img.shields.io/travis/brifordwylie/dpkt/master.png?style=flat:target:https://travis-ci.org/brifordwylie/dpkt)
+![coveralls](http://img.shields.io/coveralls/brifordwylie/dpkt/master.png?style=flat:target:https://coveralls.io/r/brifordwylie/dpkt)
+![landscape](https://landscape.io/github/brifordwylie/dpkt/master/landscape.svg?style=flat:target:https://landscape.io/github/brifordwylie/dpkt/master)
+![version](http://img.shields.io/pypi/v/dpkt.png?style=flat:target:https://pypi.python.org/pypi/dpkt)
+
+![downloads](http://img.shields.io/pypi/dm/dpkt.png?style=flat:target:https://pypi.python.org/pypi/dpkt)
+![wheel](https://pypip.in/wheel/dpkt/badge.png?style=flat:target:https://pypi.python.org/pypi/dpkt)
+![supported-versions](https://pypip.in/py_versions/dpkt/badge.png?style=flat:target:https://pypi.python.org/pypi/dpkt)
+![supported-implementations](https://pypip.in/implementation/dpkt/badge.png?style=flat:target:https://pypi.python.org/pypi/dpkt)
+
+
+Installation
+------------
+
+ pip install dpkt
+
+Documentation
+-------------
+
+
+
+Development
+-----------
+
+To run the all tests run:
+
+ tox
+
+### Deviations from upstream
+
+This code is based on [dpkt code](https://code.google.com/p/dpkt/) lead
+by Dug Song.
+
+At this point, this is not the exact [upstream
+version](https://code.google.com/p/dpkt/). If you are looking for the
+latest stock dpkt, please get it from the above link.
+
+Almost all of the upstream changes are pulled. However, some modules are
+not. Here is a list of the changes:
+
+- [dpkt/dpkt.py](https://github.com/kbandla/dpkt/commit/336fe02b0e2f00b382d91cd42558a69eec16d6c7):
+ decouple dnet from dpkt
+- [dpkt/dns.py](https://github.com/kbandla/dpkt/commit/2bf3cde213144391fd90488d12f9ccce51b5fbca)
+ : parse some more DNS flags
+
+#### Examples
+
+[@jonoberheide's]() old examples still
+apply:
+
+- [dpkt Tutorial \#1: ICMP
+ Echo](https://jon.oberheide.org/blog/2008/08/25/dpkt-tutorial-1-icmp-echo/)
+- [dpkt Tutorial \#2: Parsing a PCAP
+ File](https://jon.oberheide.org/blog/2008/10/15/dpkt-tutorial-2-parsing-a-pcap-file/)
+- [dpkt Tutorial \#3: dns
+ spoofing](https://jon.oberheide.org/blog/2008/12/20/dpkt-tutorial-3-dns-spoofing/)
+- [dpkt Tutorial \#4: AS Paths from
+ MRT/BGP](https://jon.oberheide.org/blog/2009/03/25/dpkt-tutorial-4-as-paths-from-mrt-bgp/)
+
+[Jeff Silverman](https://github.com/jeffsilverm) has some
+[code](https://github.com/jeffsilverm/dpkt_doc) and
+[documentation](http://www.commercialventvac.com/dpkt.html).
+
+#### LICENSE
+
+BSD 3-Clause License, as the upstream project
diff --git a/README.rst b/README.rst
index d77b8f4..7dbd0fa 100644
--- a/README.rst
+++ b/README.rst
@@ -3,8 +3,6 @@
dpkt
====
-fast, simple packet creation / parsing, with definitions for the basic TCP/IP protocols
-
| |docs| |travis| |coveralls| |landscape| |version|
| |downloads| |wheel| |supported-versions| |supported-implementations|
diff --git a/dpkt/__init__.py b/dpkt/__init__.py
index 6c3b493..cd57a9b 100644
--- a/dpkt/__init__.py
+++ b/dpkt/__init__.py
@@ -4,7 +4,7 @@ __author__ = 'Dug Song '
__copyright__ = 'Copyright (c) 2004 Dug Song'
__license__ = 'BSD'
__url__ = 'http://dpkt.googlecode.com/'
-__version__ = '1.8.4'
+__version__ = '1.8.5'
from dpkt import *
diff --git a/setup.py b/setup.py
index 808deff..17e7511 100755
--- a/setup.py
+++ b/setup.py
@@ -9,8 +9,10 @@ except ImportError:
package_name = 'dpkt'
description = 'dumb packet processing python module'
readme = open('README.rst').read()
-requirements = [
-]
+requirements = [ ]
+
+# PyPI Readme
+long_description = open('README.rst').read()
# Pull in the package
package = __import__(package_name)
@@ -20,6 +22,7 @@ setup(name=package_name,
author=package.__author__,
url=package.__url__,
description=description,
+ long_description=long_description,
packages=['dpkt'],
install_requires=requirements,
zip_safe=False,