Update README.md

Initial commit of content

README.md

@@ -1 +1,30 @@
-# awesome-i2p
+# Awesome I2P
+
+A curated list of awesome I2P implementations, libraries, resources, projects, and shiny things. Inspired by [awesome-tor](https://github.com/ajvb/awesome-tor) and [awesome-cpp](https://github.com/fffaraz/awesome-cpp) and other awesome lists.
+
+### What is I2P?
+I2P is an anonymous overlay network - a network within a network. It is intended to protect communication from dragnet surveillance and monitoring by third parties such as ISPs.
+I2P is used by many people who care about their privacy: activists, oppressed people, journalists and whistleblowers, as well as the average person.
+
+
+### Contents
+- [The I2P Project](#the-i2p-project)
+- [Implementations](#implementations)
+    - [I2P (Java)](#i2p)
+    - [I2Pd (C++)](#i2pd)
+
+## The I2P Project
+
+#### [geti2p.net](http://geti2p.net/)
+#### [i2pforum.net](https://i2pforum.net/)
+
+## Implementations
+
+### I2P
+[I2P](https://github.com/i2p/i2p.i2p) - The first implementation. Written in Java.
+
+### I2Pd
+[I2Pd](https://github.com/PurpleI2P/i2pd) - A C++ implementation of a I2P router.
+
+
+